EasyHAProxy

Service discovery for HAProxy

EasyHAProxy dynamically creates haproxy.cfg based on metadata from your workloads — Docker labels, Swarm service labels, or Kubernetes Ingress annotations. No HAProxy knowledge required.

Features

Automatic service discovery — Docker, Docker Swarm, Kubernetes, or static YAML
Zero-downtime HAProxy reload — configuration updates happen without dropping connections
Automatic TLS with ACME — Let's Encrypt, ZeroSSL, BuyPass, and more
Custom SSL certificates — volume-mount or label-embed your own PEM files
TCP mode — proxy any TCP service, not just HTTP
Plugin system — JWT validation, IP whitelisting, Cloudflare IP restoration, FastCGI, path blocking, and custom plugins
Real-time monitoring dashboard — built-in, zero-dependency web UI with live traffic charts, frontend/backend health, and per-server stats (enabled with a single env var)
Balance algorithms — roundrobin, leastconn, source, uri, and more

Supported platforms

Install using tools:

Documentation

Section	Description
Getting Started	Choose your runtime and discovery mode, minimal working setup
Guides	SSL, ACME, plugins, Helm, MicroK8s, Dokku, DigitalOcean
Concepts	Service discovery, config pipeline, plugin model, TLS termination
Reference	Environment variables, container labels, CLI flags, volumes

Who is using?

EasyHAProxy is part of some projects:

Monitoring Dashboard

A real-time dashboard is available at http://<host>:11936/ whenever HAPROXY_PASSWORD is set — no extra containers, no Prometheus, no Grafana. See the dashboard guide.