Skip to main content

Docker environment variables

Environment VariableDescriptionDefault
EASYHAPROXY_DISCOVERHow the services will be discovered to create haproxy.cfg: static, docker, swarm or kubernetesrequired
EASYHAPROXY_LABEL_PREFIX(Optional) The key will search for matching resources.easyhaproxy
EASYHAPROXY_CERTBOT_*(Optional) Enable Let's Encrypt or any other ACME certificate. See more: acmeempty
EASYHAPROXY_SSL_MODE(Optional) strict supports only the most recent TLS version; default good SSL integration with recent browsers; loose supports all old SSL protocols for old browsers (not recommended).default
EASYHAPROXY_REFRESH_CONF(Optional) Check for new containers/services every N seconds.10
EASYHAPROXY_LOG_LEVEL(Optional) The log level for EasyHAproxy messages. Available: TRACE,DEBUG,INFO,WARN,ERROR,FATALDEBUG
CERTBOT_LOG_LEVEL(Optional) The log level for Certbot messages. Available: TRACE,DEBUG,INFO,WARN,ERROR,FATALDEBUG
HAPROXY_LOG_LEVEL(Optional) The log level for HAProxy messages. Available: TRACE,DEBUG,INFO,WARN,ERROR,FATALINFO
HAPROXY_USERNAME(Optional) The HAProxy username for the statistics endpoint (used only when HAPROXY_PASSWORD is set).admin
HAPROXY_PASSWORD(Optional) The HAProxy password to the statistics endpoint. Stats are disabled unless this is defined.empty
HAPROXY_STATS_PORT(Optional) The HAProxy port to the statistics. If set to false, disable statistics. Only applies when HAPROXY_PASSWORD is defined.1936
HAPROXY_CUSTOMERRORS(Optional) If HAProxy will use custom HTML errors. true/false.false
HAProxy Stats

Statistics are only configured when HAPROXY_PASSWORD is set. Without a password, the stats section is not generated.

ACME/Certbot Environment Variables

For ACME/Certbot configuration (Let's Encrypt, ZeroSSL, etc.), see the ACME documentation for the complete list of EASYHAPROXY_CERTBOT_* variables.


Open source ByJG