Installation

Install HAProxy Enterprise on BSD

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
3.0r1 Oct 2024 Feb 2029
  • FreeBSD 13.4
Other HAProxy Enterprise versions
HAProxy Enterprise version Release date End of life Supported OS
3.0r1 Oct 2024 Feb 2029
  • FreeBSD 13.4
2.9r1 May 2024 Feb 2025
  • FreeBSD 13.2
2.8r1 Oct 2023 Feb 2028
  • FreeBSD 13.2
2.7r1 Feb 2023 Feb 2024
  • FreeBSD 12.4
2.6r1 Sep 2022 Feb 2027
  • FreeBSD 12.4
2.4r1 Nov 2021 Feb 2026
  • FreeBSD 12.4
2.2r1 Nov 2020 Feb 2025
  • FreeBSD 12.4
2.0r1 Nov 2019 Feb 2024
  • FreeBSD 12.4

Install HAProxy Enterprise Jump to heading

The following procedure adds package repositories and installs HAProxy Enterprise 3.0r1.

  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.

    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>
  3. Enable and start the HAProxy Enterprise service:

    nix
    sudo service hapee_30_lb onestart
    nix
    sudo service hapee_30_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

nix
sudo pkg search -g -r 'HAPEE30R1' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE30R1' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'

Install a module Jump to heading

For example, install the update module:

nix
sudo pkg install hapee-3.0r1-lb-update
nix
sudo pkg install hapee-3.0r1-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 following these rules:

  • 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

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