How to Install HAProxy on CentOS (7, 8 or 9)

How to Install HAProxy on CentOS

Achieving balanced load distribution and consistent availability is crucial in web hosting and server management. Web server administrators and webmasters frequently grapple with the task of adeptly handling incoming traffic, particularly during surges. This is the juncture where HAProxy proves invaluable.

HAProxy, a renowned open-source software, acts as a load balancer and proxy server for TCP and HTTP-based applications. By deploying HAProxy, you can distribute the incoming traffic across multiple web servers, ensuring that no single server is overwhelmed with too many requests. This not only enhances the performance but also ensures that your web application remains available even if one or more servers fail.

The benefits of using HAProxy are manifold. It offers high availability, load balancing, and proxying for TCP and HTTP-based applications. Moreover, it’s known for its fast and reliable performance, ensuring that your applications run smoothly. If you’re using CentOS 7, 8 or 9, one of the popular Linux distributions, installing HAProxy can be a game-changer for your server management tasks.

For those who are keen on exploring other proxy server solutions, our list of the best proxy servers can be a valuable resource. Additionally, for a deeper understanding of HAProxy’s features and benefits, you can visit our detailed article on HAProxy’s features, functions, and benefits.

Let’s get started!

Step 1: Update Your System

Before diving into the installation of any software, it’s crucial to start with a system that’s current with all its packages. This not only ensures compatibility but also guarantees that you’re working with the latest security patches and software updates.

To update your CentOS system:

Open your terminal or SSH into your server and enter the following command:

yum update -y

This command will fetch the latest versions of installed packages and upgrade them. The -y flag automatically answers ‘yes’ to any prompts, streamlining the process.

Step 2: Add the HAProxy Repository

HAProxy, while popular, isn’t available in the default CentOS repositories. To access the latest version of HAProxy, you’ll need to add the EPEL (Extra Packages for Enterprise Linux) repository, which contains additional packages for enterprise Linux.

See also  How to Configure HAProxy for Load Balancing with Sticky Sessions

To add the EPEL repository:

In your terminal, type the following command:

sudo yum -y install epel-release

This command installs the EPEL repository package. Once this is done, your system will have access to many more packages, including the latest version of HAProxy.

Step 3: Install HAProxy

With the EPEL repository added to your system, you’re now ready to install HAProxy.

Still in your terminal, enter the following command:

sudo yum -y install haproxy

This command fetches the HAProxy package from the EPEL repository and installs it on your system. The installation process might prompt you about the disk space that will be used. Since we’re using the -y flag, it will automatically confirm and proceed with the installation.

Once the installation is complete, HAProxy will be installed on your CentOS system, but it won’t be running yet. In subsequent steps, you’ll configure and start the HAProxy service.

Step 4: Configure HAProxy

After the installation of HAProxy, the next crucial step is its configuration. Proper configuration ensures that HAProxy efficiently balances the load among your servers and operates optimally.

HAProxy’s primary configuration file is /etc/haproxy/haproxy.cfg. This file contains various settings and parameters that dictate how HAProxy behaves and manages incoming traffic.

To modify the configuration file, you’ll need a text editor. For this tutorial, we’ll use nano, a popular and user-friendly text editor. If you prefer another editor like vim or emacs, feel free to use that instead.

In your terminal, type the following command to open the configuration file in nano:

sudo nano /etc/haproxy/haproxy.cfg

Once inside, you’ll see various sections and parameters. Here’s a brief overview of some key sections:

  • global: This section contains global settings like the HAProxy process’s user and group, log settings, and maximum connection settings.
  • defaults: Settings in this section apply to all other sections unless specifically overridden.
  • frontend: This section defines how incoming traffic is managed. It specifies the IP and port on which HAProxy listens for incoming connections.
  • backend: Here, you specify the servers to which HAProxy should distribute the incoming traffic.
See also  How to Set Up HAProxy Logging on Linux Systems

For this example, let’s say you want HAProxy to balance the load between two web servers. Here’s a simple configuration:

frontend http_front
   bind *:80
   default_backend http_back

backend http_back
   balance roundrobin
   server web1 check
   server web2 check

In this configuration:

  • HAProxy listens for HTTP traffic on port 80.
  • Incoming traffic is directed to the http_back backend.
  • The backend has two servers (web1 and web2), and HAProxy distributes the traffic between them using a round-robin algorithm.

After making your modifications, save the file and exit the editor. In nano, you can do this by pressing CTRL + O to write changes and CTRL + X to exit.

The above is just a basic example. HAProxy’s configuration can be much more complex, depending on your needs. See our HAProxy tutorials more advanced configurations.

Step 5: Start and Enable HAProxy

After configuring, start HAProxy and enable it to launch at boot:

sudo systemctl start haproxy
sudo systemctl enable haproxy

Step 6: Adjust Firewall Settings

If you have a firewall enabled, you’ll need to adjust the settings to allow traffic through HAProxy:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

Commands Mentioned:

  • yum update -y – Updates all packages on the system
  • sudo yum -y install epel-release – Installs the EPEL repository
  • sudo yum -y install haproxy – Installs HAProxy
  • sudo nano /etc/haproxy/haproxy.cfg – Opens the HAProxy configuration file in the nano text editor
  • sudo systemctl start haproxy – Starts the HAProxy service
  • sudo systemctl enable haproxy – Enables HAProxy to start on boot
  • sudo firewall-cmd –permanent –add-service=http – Allows HTTP traffic through the firewall
  • sudo firewall-cmd –permanent –add-service=https – Allows HTTPS traffic through the firewall
  • sudo firewall-cmd –reload – Reloads the firewall settings


Installing HAProxy on CentOS is a straightforward process that can significantly enhance the performance and reliability of your web applications. By following the steps outlined in this tutorial, you’ve equipped your CentOS server with a powerful tool that ensures optimal load distribution and high availability. Remember, the key to maximizing the benefits of HAProxy lies in its configuration. Tailor it to your specific needs and monitor its performance regularly.

See also  How to Update CentOS 6.4 System using 'yum update'

We’ve covered the essential steps to get HAProxy up and running on CentOS. However, the world of server management is vast, and there’s always more to learn. If you’re interested in exploring other web server solutions, our guides on Apache HTTP Server, Nginx Server, and LiteSpeed Web Server can provide further insights. Additionally, for those looking to delve deeper into hosting types, our articles on Dedicated Server Hosting, VPS Hosting, and Cloud Hosting are invaluable resources.

I hope this tutorial has been informative and valuable. If you have any questions, feedback, or insights to share, please leave a comment below. Your feedback helps us improve and provide more comprehensive guides in the future.


  1. What is the primary purpose of HAProxy?

    HAProxy primarily serves as a load balancer and proxy server for TCP and HTTP-based applications. It distributes incoming traffic across multiple servers, ensuring optimal load distribution and high availability.

  2. Is HAProxy suitable for all CentOS versions?

    This tutorial covers the installation of HAProxy on CentOS versions 7, 8, and 9. While the steps are primarily tailored for these versions, HAProxy can be installed on other CentOS versions with slight modifications to the process.

  3. How does HAProxy enhance web application performance?

    HAProxy enhances web application performance by efficiently distributing incoming traffic across multiple servers. This ensures that no single server is overwhelmed, leading to faster response times and reduced server downtime.

  4. Can I use HAProxy with other Linux distributions?

    Yes, HAProxy is versatile and can be installed on various Linux distributions. While this tutorial focuses on CentOS, the installation process for other distributions like Ubuntu or Debian might differ slightly.

  5. Do I need to adjust firewall settings after installing HAProxy?

    Yes, if you have a firewall enabled on your CentOS server, you’ll need to adjust the settings to allow traffic through HAProxy, especially if you’re serving HTTP or HTTPS traffic.


Leave a Reply

Your email address will not be published. Required fields are marked *