Installation

Install HAProxy Enterprise on BSD

On this page

Using HAProxy Fusion?

If you’re using HAProxy Fusion, then see the HAProxy Fusion - Nodes topic instead.

This section describes how to install HAProxy Enterprise on BSD.

Supported operating systems Jump to heading

HAProxy Enterprise is distributed through the Operating System package manager for the following Linux distributions:

HAProxy Enterprise version Release date End of life Supported OS (architecture)
3.1r1 Feb 2025 Feb 2026
  • FreeBSD 13.4 (amd64)
Other HAProxy Enterprise versions
HAProxy Enterprise version Release date End of life Supported OS (architecture)
3.1r1 Feb 2025 Feb 2026
  • FreeBSD 13.4 (amd64)
3.0r1 Oct 2024 Feb 2029
  • FreeBSD 13.4 (amd64)
2.8r1 Oct 2023 Feb 2028
  • FreeBSD 13.2 (amd64)
2.6r1 Sep 2022 Feb 2027
  • FreeBSD 12.4 (amd64)
2.4r1 Nov 2021 Feb 2026
  • FreeBSD 12.4 (amd64)

Install HAProxy Enterprise Jump to heading

The following procedure adds package repositories and installs HAProxy Enterprise.

  1. Optional: To verify the integrity of the script before installing, first download the script and its SHA hash to a local directory:

    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh.sha512.asc
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh.sha512.asc

    Then run these commands to verify the checksum of the script against the SHA hash:

    nix
    gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 0xCA2DF14657C5A207
    gpg --verify ./install_haproxy_enterprise.sh.sha512.asc
    nix
    gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 0xCA2DF14657C5A207
    gpg --verify ./install_haproxy_enterprise.sh.sha512.asc

    Check for the output Good signature.

  2. To install HAProxy Enterprise, run the following command, replacing <HAProxy Enterprise Key> with your HAProxy Enterprise license key.

    Install the software
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 3.1r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 3.1r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 3.0r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 3.0r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 2.8r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 2.8r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 2.6r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 2.6r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 2.4r1 \
      --key <HAProxy Enterprise key>
    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
      --version 2.4r1 \
      --key <HAProxy Enterprise key>

  3. Enable and start the HAProxy Enterprise service:

    Enable and start the service
    nix
    sudo service hapee_31_lb onestart
    nix
    sudo service hapee_31_lb onestart
    nix
    sudo service hapee_30_lb onestart
    nix
    sudo service hapee_30_lb onestart
    nix
    sudo service hapee_28_lb onestart
    nix
    sudo service hapee_28_lb onestart
    nix
    sudo service hapee_26_lb onestart
    nix
    sudo service hapee_26_lb onestart
    nix
    sudo service hapee_24_lb onestart
    nix
    sudo service hapee_24_lb onestart

Install additional modules Jump to heading

HAProxy Enterprise comes with additional native and third-party modules.

Search for additional modules Jump to heading

Search for additional modules
nix
sudo pkg search -g -r 'HAPEE31' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE31' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE30' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE30' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE28' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE28' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE26' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE26' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE24' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE24' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'

Install modules Jump to heading

Install a module

For example, install the update module:

nix
sudo pkg install hapee-3.1r1-lb-update
nix
sudo pkg install hapee-3.1r1-lb-update

For example, install the update module:

nix
sudo pkg install hapee-3.0r1-lb-update
nix
sudo pkg install hapee-3.0r1-lb-update

For example, install the update module:

nix
sudo pkg install hapee-2.8r1-lb-update
nix
sudo pkg install hapee-2.8r1-lb-update

For example, install the update module:

nix
sudo pkg install hapee-2.6r1-lb-update
nix
sudo pkg install hapee-2.6r1-lb-update

For example, install the update module:

nix
sudo pkg install hapee-2.4r1-lb-update
nix
sudo pkg install hapee-2.4r1-lb-update

See other parts of this documentation for instructions on how to enable and configure each package.

Locate installed directories Jump to heading

HAProxy Enterprise files are installed in the following directories.

Installation directories
  • Binaries and documentation are in /usr/local/opt/hapee-3.1/.
text
/usr/local/opt/hapee-3.1/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
text
/usr/local/opt/hapee-3.1/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
  • Configuration is installed in /usr/local/etc/hapee-3.1/.
text
/usr/local/etc/hapee-3.1/
  |-- hapee-lb.cfg
text
/usr/local/etc/hapee-3.1/
  |-- hapee-lb.cfg
  • init scripts are installed in /usr/local/etc/rc.d/.
text
/usr/local/etc/rc.d/
  |-- hapee_31_lb
text
/usr/local/etc/rc.d/
  |-- hapee_31_lb
  • Binaries and documentation are in /usr/local/opt/hapee-3.0/.
text
/usr/local/opt/hapee-3.0/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
text
/usr/local/opt/hapee-3.0/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
  • Configuration is installed in /usr/local/etc/hapee-3.0/.
text
/usr/local/etc/hapee-3.0/
  |-- hapee-lb.cfg
text
/usr/local/etc/hapee-3.0/
  |-- hapee-lb.cfg
  • init scripts are installed in /usr/local/etc/rc.d/.
text
/usr/local/etc/rc.d/
  |-- hapee_30_lb
text
/usr/local/etc/rc.d/
  |-- hapee_30_lb
  • Binaries and documentation are in /usr/local/opt/hapee-2.8/.
text
/usr/local/opt/hapee-2.8/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
text
/usr/local/opt/hapee-2.8/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
  • Configuration is installed in /usr/local/etc/hapee-2.8/.
text
/usr/local/etc/hapee-2.8/
  |-- hapee-lb.cfg
text
/usr/local/etc/hapee-2.8/
  |-- hapee-lb.cfg
  • init scripts are installed in /usr/local/etc/rc.d/.
text
/usr/local/etc/rc.d/
  |-- hapee_28_lb
text
/usr/local/etc/rc.d/
  |-- hapee_28_lb
  • Binaries and documentation are in /usr/local/opt/hapee-2.6/.
text
/usr/local/opt/hapee-2.6/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
text
/usr/local/opt/hapee-2.6/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
  • Configuration is installed in /usr/local/etc/hapee-2.6/.
text
/usr/local/etc/hapee-2.6/
  |-- hapee-lb.cfg
text
/usr/local/etc/hapee-2.6/
  |-- hapee-lb.cfg
  • init scripts are installed in /usr/local/etc/rc.d/.
text
/usr/local/etc/rc.d/
  |-- hapee_26_lb
text
/usr/local/etc/rc.d/
  |-- hapee_26_lb
  • Binaries and documentation are in /usr/local/opt/hapee-2.4/.
text
/usr/local/opt/hapee-2.4/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
text
/usr/local/opt/hapee-2.4/
  |-- bin
  |-- dev
  |-- doc
  |-- modules
  |-- sbin
  |-- version
  • Configuration is installed in /usr/local/etc/hapee-2.4/.
text
/usr/local/etc/hapee-2.4/
  |-- hapee-lb.cfg
text
/usr/local/etc/hapee-2.4/
  |-- hapee-lb.cfg
  • init scripts are installed in /usr/local/etc/rc.d/.
text
/usr/local/etc/rc.d/
  |-- hapee_24_lb
text
/usr/local/etc/rc.d/
  |-- hapee_24_lb

Do you have any suggestions on how we can improve the content of this page?

Previous page Azure Next page Docker
© 2025 HAProxy Technologies, LLC. All Rights Reserved
Manage Cookie Preferences