HAProxy Enterprise is distributed through the Operating System package manager.

We offer two ways of installing our product:

  • A quick procedure where you run a script to install the load balancer and its associated components (see Quick installation), or

  • A step-by-step procedure with detailed explanations at each stage of the installation of the load balancer and its associated components (see the section Detailed installation).

Quick installation

This procedure imports your HAProxy Enterprise key and installs the load balancer and associated components in the "extras" repository.

  1. Copy the script below and save it in a file.

  2. Replace the tag [YOURKEYHERE] with your HAProxy Enterprise key where indicated.

  3. Run the script.

    sudo su -
    DEBNAME=$(lsb_release -cs)
    cat <<EOF > /etc/apt/sources.list.d/hapee.list
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/$KEY-common/$VERSION/ubuntu-18.04/amd64/ bionic main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/$KEY-plus/$VERSION/ubuntu-18.04/amd64/ bionic main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/$KEY-plus/extras/ubuntu-18.04/amd64/ bionic main
    curl -s -L "$URL" | apt-key add -
    apt-get update
    apt-get install --yes apt-transport-https
    apt-get install --yes hapee-$VERSION-lb
    ls -lha /opt

Detailed installation

The following procedure gives detailed explanations at each stage of the installation of the load balancer and its associated components.

To start, proceed as follows:

  1. Create the repository file.

  2. Install HAProxy Enterprise, components, and 'extras'.


HAProxy Enterprise components include modules, scripts, tools, and optimized third party software.

Create the repository file

The repository file holds repositories for the load balancer, HAProxy Enterprise components, and 'extras'.

  • The components repository includes modules, scripts, tools, and optimized third party software.

  • The 'extras' repository includes components that are independent of HAProxy Enterprise versions.


    The package hapee-extras-route contains the program /opt/hapee-extras/bin/hapee-route-cli, which you can use to run "show protocols" and "show route"; it supports the normal BIRD socket commands.

  1. Create a new repository description file in /etc/apt/sources.list.d/.


    The extension of the file must be list. IE: hapee.list

  2. In the file /etc/apt/sources.list.d/hapee.list, add the contents below to copy the repositories for the load balancer and HAProxy Enterprise components, and 'extras'.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.8r2/ubuntu-18.04/amd64/ bionic main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/1.8r2/ubuntu-18.04/amd64/ bionic main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/extras/ubuntu-18.04/amd64/ bionic main
  3. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

Install HAProxy Enterprise, components, and 'extras'

About dependencies

When required, apt resolves dependencies and automatically installs them.

Import HAProxy Technologies public key

  • The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key:

curl -s -L https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/HAPEE-key-1.8r2.asc | apt-key add -

Enable HTTPS

  • To allow apt to access repositories over HTTPS, run:

    apt-get install apt-transport-https

Update the repository cache

  • Run apt-get update to update the repository cache.


    HAProxy Enterprise repositories are 64 bits only. In some cases, the operating system may not find i386 packages. If this happens, add [arch=amd64] after the deb keyword of your HAProxy Enterprise repository file.

Install the load balancer

  • To install the load balancer, run:

    apt-get install hapee-1.8r2-lb

    Output of a successful installation:

    Reading package lists... Done
    Building dependency tree
    Reading state information... Done
    The following extra packages will be installed:
           hapee-1.8r2-base openssl
    Suggested packages:
    The following NEW packages will be installed:
           hapee-1.8r2-base hapee-1.8r2-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.

Search for package names

  • To find packages related to HAProxy Enterprise 1.8r2, run:

    apt-cache search hapee-1.8r2
  • To find packages related to HAProxy Enterprise 'extras', run:

    apt-cache search hapee-extras

    Output of successful search:

    hapee-1.8r2-base.noarch : HAPEE BASE : Common dependencies
    hapee-1.8r2-cli.x86_64 : HAPEE CLI : Command line interface for HAPEE LB (socat)
    hapee-1.8r2-cli-debuginfo.x86_64 : Debug information for package hapee-1.8r2-cli
    hapee-1.8r2-lb.x86_64 : HAPEE LB : Layer 7 load-balancing (HAProxy)
    hapee-1.8r2-lb-debuginfo.x86_64 : Debug information for package hapee-1.8r2-lb
    hapee-1.8r2-lb-dev.x86_64 : HAPEE LB : development files
    hapee-extras-vrrp.x86_64 : HAPEE VRRP : VRRP daemon (Keepalived).
    hapee-extras-vrrp-debuginfo.x86_64 : Debug information for package hapee-extras-vrrp

Locate destination directories

HAProxy Enterprise files are installed following these rules:

  • Binaries and documentation are in /opt/hapee-1.8/

        |-- bin
        |-- certs
        |-- doc
        |-- misc
        |-- misc
        |-- modules
        \`-- sbin
  • Configuration is installed in /etc/hapee-1.8/

      |-- hapee-lb.cfg
        |-- hapee-log.cfg
        |-- hapee-snmp.cfg
        \`-- hapee-vrrp.cfg


    HAProxy Enterprise Extensions may also add some files here.

  • init scripts are installed in /etc/init.d/

      |-- hapee-1.8
      |-- hapee-1.8-lb
      |-- hapee-extras-snmp-lb
      |-- hapee-extras-stktagg
      |-- hapee-extras-spoa-sso
      |-- hapee-extras-route
      |-- hapee-extras-rhi
      \`-- hapee-extras-vrrp


    HAProxy Enterprise Extensions may also add some files here.

Enable services

  • To start HAProxy Enterprise, run:

    systemctl start hapee-1.8

For more information on how to configure HAProxy Enterprise to start with your system, refer to the documentation related to systemd administration.


After you complete the installation, you can configure HAProxy Enterprise using the instructions in the Configuration section from the left-hand menu bar.