{"id":2362,"date":"2015-12-18T18:17:43","date_gmt":"2015-12-18T16:17:43","guid":{"rendered":"https:\/\/upcloud.com\/global\/us\/resources\/tutorials\/haproxy-load-balancer-ubuntu\/"},"modified":"2015-12-18T18:17:43","modified_gmt":"2015-12-18T16:17:43","slug":"haproxy-load-balancer-ubuntu","status":"publish","type":"tutorial","link":"https:\/\/upcloud.com\/global\/resources\/tutorials\/haproxy-load-balancer-ubuntu\/","title":{"rendered":"How to install HAProxy load balancer on Ubuntu"},"content":{"rendered":"\n

Try this guide out on UpCloud with our free trial!\u00a0Get started<\/a><\/h3>\n\n\n\n

Load balancing is a common solution for distributing web applications horizontally across multiple hosts while providing the users with a single point of access to the service. HAProxy<\/a> is one of the most popular open-source load-balancing software, which also offers high availability and proxy functionality.<\/p>\n\n\n\n\n\n

HAProxy aims to optimise resource usage, maximise throughput, minimise response time, and avoid overloading any single resource. It is available for installation on many Linux distributions like Ubuntu 16 in this guide, but also on Debian 8<\/a> and CentOS 7<\/a> systems.<\/p>\n\n\n\n

\"HAproxy<\/figure>\n\n\n\n

HAProxy is particularly suited for very high-traffic websites and is often used to improve web service reliability and performance for multi-server configurations. This guide lays out the steps for setting up HAProxy as a load balancer on Ubuntu 16 to its cloud host, which then directs the traffic to your web servers.<\/p>\n\n\n\n

As a pre-requirement for the best results, you should have a minimum of two web servers and a server for the load balancer. The web servers need to be running at least the basic web services such as Apache2 or Nginx to test the load balance between them.<\/p>\n\n\n\n

\n
Try UpCloud for free!<\/a><\/div>\n<\/div>\n\n\n\n

Installing HAProxy 1.7<\/h2>\n\n\n\n

As a fast-developing open-source application, HAProxy, available for installation in the Ubuntu default repositories, might not be the latest release. To determine what version number is offered through the official channels, enter the following command.<\/p>\n\n\n\n

sudo apt show haproxy<\/pre>\n\n\n\n
HAProxy has always three active stable versions of the releases, two of the latest versions in development plus a third older version that is still receiving critical updates. You can always check the currently newest stable version listed on the HAProxy website and then decide which version you wish to go with.<\/p>\n\n\n\n
While the latest stable version 1.7 of HAProxy is not yet available on the packet manager by default, it can be found in a third-party repository. To install HAProxy from an outside repo, you will need to add the new repository with the following command.<\/p>\n\n\n\n
sudo add-apt-repository ppa:vbernat\/haproxy-1.7<\/pre>\n\n\n\n
Confirm adding the new PPA by pressing the Enter<\/em> key.<\/p>\n\n\n\n
Next, update your sources list.<\/p>\n\n\n\n
sudo apt update<\/pre>\n\n\n\n
Then install HAProxy as you normally would.<\/p>\n\n\n\n
sudo apt install -y haproxy<\/pre>\n\n\n\n
Afterwards, you can double check the installed version number with the following command.<\/p>\n\n\n\n
haproxy -v<\/pre>\n\n\n\n
HA-Proxy version 1.7.8-1ppa1~xenial 2017\/07\/09\nCopyright 2000-2017 Willy Tarreau <willy@haproxy.org><\/pre>\n\n\n\n
<\/a>The installation is then complete. Continue below with the instructions for how to configure the load balancer to redirect requests to your web servers.<\/p>\n\n\n\n
Configuring the load balancer<\/h2>\n\n\n\n
Setting up HAProxy for load balancing is quite a straightforward process. All you need to do is tell HAProxy what kind of connections it should be listening for and where the connections should be relayed.<\/p>\n\n\n\n
<\/a>This is done by creating a configuration file \/etc\/haproxy\/haproxy.cfg<\/tt> with the defining settings. You can read about the configuration options at HAProxy documentation page<\/a> if you wish to find out more.<\/p>\n\n\n\n
Load balancing on layer 4<\/h2>\n\n\n\n
Once installed, HAProxy should have a template for configuring the load balancer. Open the configuration file, for example, using nano<\/tt> with the command underneath.<\/p>\n\n\n\n
sudo nano \/etc\/haproxy\/haproxy.cfg<\/pre>\n\n\n\n
Add the following sections to the end of the file. Replace the <server name><\/tt> with whatever you want to call your servers on the statistics page and the <private IP><\/tt> with the private IPs for the servers you wish to direct the web traffic to. You can check the private IPs at your UpCloud Control Panel<\/a> and Private network<\/em> tab under Network<\/em> menu.<\/p>\n\n\n\n
frontend http_front\n   bind *:80\n   stats uri \/haproxy?stats\n   default_backend http_back\n\nbackend http_back\n   balance roundrobin\n   server <server1 name> <private IP 1>:80 check\n   server <server2 name> <private IP 2>:80 check<\/pre>\n\n\n\n
<\/a>This defines a layer 4 load balancer with a front-end name http_front listening to the port number 80, which then directs the traffic to the default backend named http_back. The additional stats URI \/haproxy?stats enable the statistics page at that specified address.<\/p>\n\n\n\n
Different load-balancing algorithms<\/h2>\n\n\n\n
Configuring the servers in the backend section allows HAProxy to use these servers for load balancing according to the roundrobin<\/tt> algorithm whenever available.<\/p>\n\n\n\n
The balancing algorithms are used to decide which server at the backend each connection is transferred to. Some of the useful options include the following:<\/p>\n\n\n\n