HAProxy Enterprise is distributed through the Operating System package manager.

To install it, proceed as follows:

  1. Create the repository file.

  2. Install HAProxy Enterprise and components.


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 and the HAProxy Enterprise components.

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


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/yum.repos.d/.


    The extension of the file must be repo (i.e. hapee.repo).

  2. In the file /etc/yum.repos.d/hapee.repo, add the contents below to copy the repositories for the load balancer and HAProxy Enterprise components:

  3. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

Install HAProxy Enterprise and components

About dependencies

When required, yum 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:

rpm --import https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/HAPEE-key-1.7r2.asc

Update the repository cache

  • Run yum makecache to update the repository cache.

Install the load balancer

  • To install the load balancer run:

    yum install -y hapee-1.7r2-lb

    Output of a successful installation:

    Running Transaction
    Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
    Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
    Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
    hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
    Dependency Installed:
    hapee-1.7r2-base.noarch 0:1.7r2.0-16.0

Search for package names

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

    yum search hapee-1.7r2

    Output of a successful search:

    hapee-1.7r2-base.noarch : HAPEE BASE : Common dependencies
    hapee-1.7r2-cli.x86_64 : HAPEE CLI : Command line interface for HAPEE LB (socat)
    hapee-1.7r2-cli-debuginfo.x86_64 : Debug information for package hapee-1.7r2-cli
    hapee-1.7r2-lb.x86_64 : HAPEE LB : Layer 7 load-balancing (HAProxy)
    hapee-1.7r2-lb-debuginfo.x86_64 : Debug information for package hapee-1.7r2-lb
    hapee-1.7r2-lb-dev.x86_64 : HAPEE LB : developpement files

Locate destination directories

HAProxy Enterprise files are installed following these rules:

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

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

      |-- 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.7
      |-- hapee-1.7-lb
      |-- hapee-1.7-snmp-lb
      |-- hapee-1.7-stktagg
      |-- hapee-1.7-route
      |-- hapee-1.7-rhi
     \`-- hapee-1.7-vrrp


    HAProxy Enterprise Extensions may also add some files here.

Enable services

  • To start HAProxy Enterprise, run:

    systemctl start hapee-1.7

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.