haproxytech/haproxy-alpine

Supported tags and respective Dockerfile links

• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/3.4/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/3.3/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/3.2/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/3.1/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/3.0/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/2.8/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/2.6/Dockerfile
• https://github.com/haproxytech/haproxy-docker-alpine/blob/main/2.4/Dockerfile

Quick reference

• Where to get help:
  HAProxy mailing list, HAProxy Community Slack or #haproxy on Libera.chat

• Where to file issues:
  https://github.com/haproxytech/haproxy-docker-alpine/issues

• Maintained by:
  https://github.com/haproxytech

• Supported architectures: (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  linux/amd64, linux/arm64. linux/arm/v6, linux/arm/v7, linux/386

• Image updates:
  https://github.com/haproxytech/haproxy-docker-alpine/commits/main, https://github.com/haproxytech/haproxy-docker-alpine

• Source of this description:
  https://github.com/haproxytech/haproxy-docker-alpine/blob/main/README.md

What is HAProxy?

HAProxy is the fastest and most widely used open-source load *** and application delivery controller. Written in C, it has a reputation for efficient use of both processor and memory. It can proxy at either layer 4 (TCP) or layer 7 (HTTP) and has additional features for inspecting, routing and modifying HTTP messages.

It comes bundled with a web UI, called the HAProxy Stats page, that you can use to monitor error rates, the volume of traffic and latency. Features can be toggled on by updating a single configuration file, which provides a syntax for defining routing rules, rate limiting, access controls, and more.

Other features include:

• SSL/TLS termination
• Gzip compression
• Health checking
• HTTP/2
• gRPC support
• Lua scripting
• DNS service discovery
• Automatic retries of failed connections
• Verbose logging

!logo

How to use this image

This image is being shipped with a trivial sample configuration and for any real life use it should be configured according to the extensive documentation and https://github.com/haproxy/haproxy/tree/master/examples. We will now show how to override shipped haproxy.cfg with one of your own.

Create a Dockerfile

dockerfile
FROM haproxytech/haproxy-alpine:3.0
COPY haproxy.cfg /usr/local/etc/haproxy/haproxy.cfg

Build the container

console
$ docker build -t my-haproxy .

Test the configuration file

console
$ docker run -it --rm my-haproxy haproxy -c -f /usr/local/etc/haproxy/haproxy.cfg

Run the container

console
$ docker run -d --name my-running-haproxy my-haproxy

You will also need to publish the ports your HAProxy is listening on to the host by specifying the -p option, for example -p 8080:80 to publish port 8080 from the container host to port 80 in the container.

Use volume for configuration persistency

console
$ docker run -d --name my-running-haproxy -v /path/to/etc/haproxy:/usr/local/etc/haproxy:ro haproxytech/haproxy-alpine:3.0

Note that your host's /path/to/etc/haproxy folder should be populated with a file named haproxy.cfg as well as any other accompanying files local to /etc/haproxy.

Reloading config

To be able to reload HAProxy configuration, you can send SIGUSR2 to the container:

console
$ docker kill -s USR2 my-running-haproxy

Enable Data Plane API

To use Data Plane API it is easiest to use s6-tagged images which all have Data Plane API running by default.

License

View https://raw.githubusercontent.com/haproxy/haproxy/master/LICENSE for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).