Image Overview: haproxy

Overview: haproxy Chainguard Image

A minimal haproxy base image rebuilt every night from source.

Download this Image

The image is available on

docker pull


Similar to the docker-library/haproxy image, this image does not come with any default configuration.

Please refer to upstream’s excellent (and comprehensive) documentation on the subject of configuring HAProxy for your needs.

Let say you have a haproxy.cfg config file is current working directory. To test that configuration file, you can run the following command

docker run -it --rm -v "$(pwd):/etc/haproxy" --name haproxy-syntax-check haproxy -c -f /etc/haproxy/haproxy.cfg

In order for the container to work, you need to mount your custom haproxy.cfg file in the container. The following example runs HAProxy with a custom configuration file:

docker run -it --rm -v "$(pwd):/etc/haproxy" haproxy -f /etc/haproxy/haproxy.cfg

Helm install

When installing in Kubernetes, securityContexts that drop [ "ALL" ] capabilities interfere with the setcap privileged haproxy. In order to support Kubernetes based installs which default to dropping ALL capabilities, the necessary modifications must be made to add back NET_ADMIN capabilities.

For example, in the ha-redis chart used by argocd, the values.yaml becomes:

# values.yaml
  enabled: true

Last updated: 2024-04-11 12:38