A Docker image is a file that comprises instructions for a complete and executable version of a program in a Docker container.

There are four HAProxy Enterprise images available in three different registries with the following respective contents:

  • hapee-registry.haproxy.com/hapee-business: base HAPEE-LB components without any additional modules from HAPEE-Plus repository

  • hapee-plus-registry.haproxy.com/hapee-business-plus: base HAPEE-LB components and all other HAPEE modules and libraries

  • hapee-plus-registry.haproxy.com/hapee-stkagg: HAPEE Stick Table Aggregator image as a main process, based on hapee-business-plus, but as a separate image to facilitate stick table aggregation

  • kubernetes-registry.haproxy.com/haproxy-ingress: HAPEE-LB as a Kubernetes Ingress Controller

Logging into the registry

Before you can pull the docker images, you must log into the corresponding HAProxy Enterprise docker registry using your "HAPEE key".


For the rest of this section, we use the hapee-business-plus image. Hence, we must log into the hapee-plus-registry.haproxy.com.

$ docker login https://hapee-plus-registry.haproxy.com
username is customer's HAProxy Enterprise key (for plus repository)
password is customer's HAProxy Enterprise key (for plus repository)

Pulling the Docker image

  • To pull the Docker image, run:

    $ docker pull hapee-plus-registry.haproxy.com/hapee-business-plus

Running HAProxy Enterprise

  • To start HAProxy Enterprise, run:

    docker run --name hapee -d -p 80:80 -p 443:443 -v /hostdir/hapee-lb.cfg:/etc/hapee-1.8/hapee-lb.cfg  hapee-plus-registry.haproxy.com/hapee-business-plus

This assigns the hapee name to the Docker container, publish ports 80 and 443, and mount the hapee-lb.cfg from in the current directory to use as the HAProxy Enterprise configuration file.

Update HAProxy

If you need to update the HAProxy configuration:

  1. Edit the file hapee-lb.cfg on the host machine.

  2. Restart the Docker container with this command:

    docker restart hapee