Image Overview: haproxy

Overview: haproxy Chainguard Image

A minimal haproxy base image rebuilt every night from source.

Get It!

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