Installation

Install HAProxy Enterprise on BSD

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
2.8r1 Oct 2023 Feb 2028
  • FreeBSD 13.2
Other HAProxy Enterprise versions
HAProxy Enterprise version Release date End of life Supported OS
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 2.8r1.

  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 the key you were given when you registered.

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

    nix
    sudo service hapee_28_lb onestart
    nix
    sudo service hapee_28_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 'HAPEE28R1' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'
nix
sudo pkg search -g -r 'HAPEE28R1' '*'
sudo pkg search -g -r 'HAPEEEXTRAS' '*'

Install a module Jump to heading

nix
sudo pkg install hapee-2.8r1-lb-update
nix
sudo pkg install hapee-2.8r1-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-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

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