[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/patricknazar/dockercloud-haproxy/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","patricknazar","reponame","dockercloud-haproxy","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2017-10-06T13:09:14.41842Z","description","","is_private","last_updated","2017-10-06T13:21:41.32152Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",208,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# dockercloud/haproxy\n\n\nHAProxy image that balances between linked containers and, if launched in Docker Cloud or using Docker Compose v2,\nreconfigures itself when a linked cluster member redeploys, joins or leaves.\n\n## Version\n\nThe available version can be found here: https://hub.docker.com/r/dockercloud/haproxy/tags/\n - `latest` is built against master branch\n - `staging` is built against staging branch\n - `x.x.x` is built against git tags on github\n\n**Attention** : Please **ALWAYS** use a specific image tag that works for you. **DO NOT** use `dockercloud/haproxy:latest` in any situation other than testing purpose.\n\n## Usage\n\nYou can use `dockercloud/haproxy` in three different ways:\n\n- running in Docker Cloud (Cloud Mode)\n- running with Docker legacy links (Legacy Mode)\n- running with Docker Compose v2 (Compose Mode, compatible with Docker Swarm)\n- running with Docker SwarmMode (Swarm Mode)\n\n### Running in Docker Cloud (Cloud Mode)\n\n1. Launch the service you want to load-balance using Docker Cloud.\n\n2. Launch the load balancer. To do this, select \"Jumpstarts\", \"Proxies\" and select `dockercloud/haproxy`. During the \"Environment variables\" step of the wizard, link to the service created earlier (the name of the link is not important), and add \"Full Access\" API role (this will allow HAProxy to be updated dynamically by querying Docker Cloud's API).\n\n\t**Note**:\n\t- If you are using `docker-cloud cli`, or `stackfile`, please set `roles` to `global`\n\t- Please **DO NOT** set `sequential_deployment: true` on this image.\n\nThat's it - the haproxy container will start querying Docker Cloud's API for an updated list of containers in the service and reconfigure itself automatically, including:\n\n* start/stop/terminate containers in the linked application services\n* start/stop/terminate/scale up/scale down/redeploy the linked application services\n* add new links to HAProxy\n* remove old links from HAProxy\n\n##### example of stackfile in Docker Cloud:\n\n\tweb:\n\t image: 'dockercloud/hello-world:latest'\n\t target_num_containers: 2\n\tlb:\n\t image: 'dockercloud/haproxy:latest'\n\t links:\n\t - web\n\t ports:\n\t - '80:80'\n\t roles:\n\t - global\n\n### Running with Docker SwarmMode (Swarm Mode)\n\nDocker 1.12 supports SwarmMode natively. `dockercloud/haproxy` will auto config itself to load balance all the services running on the same network:\n\n1. Create a new network using `docker network create -d overlay ` command\n\n2. Launch `dockercloud/haproxy` service on that network on manager nodes.\n\n3. Launch your application services that need to be load balanced on the same network.\n\n **Note**\n - You **HAVE TO** set the environment variable `SERVICE_PORTS=, ` in your application service, which are the ports you would like to expose.\n - For `dockercloud/haproxy` service:\n If you mount `/var/run/docker.sock`, it can only be run on swarm manager nodes.\n If you want the haproxy service to run on worker nodes, you need to setup DOCKER_HOST envvar that points to the manager address.\n\n* If your application services need to access other services(database, for example), you can attach your application services to two different network, one is for database and the other one for the proxy\n* This feature is still experimental, please let us know if you find any bugs or have any suggestions.\n\n#### example of docker swarm mode support\n\n docker network create -d overlay proxy\n docker service create --name haproxy --network proxy --mount target=/var/run/docker.sock,source=/var/run/docker.sock,type=bind -p 80:80 --constraint \"node.role == manager\" dockercloud/haproxy\n docker service create -e SERVICE_PORTS=\"80\" --name app --network proxy --constraint \"node.role != manager\" dockercloud/hello-world\n docker service scale app=2\n docker service update --env-add VIRTUAL_HOST=web.org app\n\n### Running with Docker legacy links (Legacy Mode)\n\nLegacy link refers to the link created before docker 1.10, and the link created in default bridge network in docker 1.10 or after.\n\n##### example of legacy links using docker cli\n\n docker run -d --name web1 dockercloud/hello-world\n docker run -d --name web2 dockercloud/hello-world\n docker run -d -p 80:80 --link web1:web1 --link web2:web2 dockercloud/haproxy\n\n#### example of docker-compose.yml v1 format:\n\n\tweb1:\n\t image: 'dockercloud/hello-world:latest'\n\tweb2:\n\t image: 'dockercloud/hello-world:latest'\n\tlb:\n\t image: 'dockercloud/haproxy:latest'\n\t links:\n\t - web1\n\t - web2\n\t ports:\n\t - '80:80'\n\n**Note**: Any link alias sharing the same prefix and followed by \"-/_\" with an integer is considered to be from the same service. For example: `web-1` and `web-2` belong to service `web`, `app_1` and `app_2` are from service `app`, but `app1` and `web2` are from different services.\n\n\n### Running with Docker Compose v2 (Compose Mode)\n\nDocker Compose 1.6 supports a new format of the compose file. In the new version(v2), the old link that injects environment variables is deprecated.\n\nSimilar to using legacy links, here list some differences that you need to notice:\n- This image must be run using Docker Compose, as it relies on the Docker Compose labels for configuration.\n- The container needs access to the docker socket, you must mount the correct files and set the related environment to make it work.\n- A link is required in order to ensure that dockercloud/haproxy is aware of which service it needs to balance, although links are not needed for service discovery since docker 1.10. Linked aliases are not required.\n- DO not overwrite `HOSTNAME` environment variable in `dockercloud/haproxy container`.\n- As it is the case on Docker Cloud, auto reconfiguration is supported when the linked services scales or/and the linked container starts/stops.\n- The container name is maintained by docker-compose, and used for service discovery as well. Please **DO NOT** change `container_name` of the linked service in the compose file to a non-standard name. Otherwise, that service will be ignored.\n\n##### example of docker-compose.yml running on Linux or Docker for Mac (beta):\n\n\tversion: '2'\n\tservices:\n\t web:\n\t image: dockercloud/hello-world\n\t lb:\n\t image: dockercloud/haproxy\n\t links:\n\t - web\n\t volumes:\n\t - /var/run/docker.sock:/var/run/docker.sock\n\t ports:\n\t - 80:80\n\n##### example of docker-compose.yml running on Mac OS\n\n\tversion: '2'\n\tservices:\n\t web:\n\t image: dockercloud/hello-world\n\t lb:\n\t image: dockercloud/haproxy\n\t links:\n\t - web\n\t environment:\n\t - DOCKER_TLS_VERIFY\n\t - DOCKER_HOST\n\t - DOCKER_CERT_PATH\n\t volumes:\n\t - $DOCKER_CERT_PATH:$DOCKER_CERT_PATH\n\t ports:\n\t - 80:80\n\nOnce the stack is up, you can scale the web service using `docker-compose scale web=3`. dockercloud/haproxy will automatically reload its configuration.\n\n#### Running with Docker Compose v2 and Swarm (using envvar)\nWhen using links like previous section, the Docker Swarm scheduler can be too restrictive.\nEven with overlay network, swarm (As of 1.1.0) will attempt to schedule haproxy on the same node as the linked service due to legacy links behavior.\nThis can cause unwanted scheduling patterns or errors such as \"Unable to find a node fulfilling all dependencies...\"\n\nSince Compose V2 allows discovery through the service names, Dockercloud haproxy only needs the links to indentify which service should be load balanced.\n\nA second option is to use the `ADDITIONAL_SERVICES` variable for indentification of services.\n\n- Set the `ADDITIONAL_SERVICES` env variable to your linked services.\n- You also want to set depends_on to ensure the web service is started before haproxy so that the hostname can be resolved. This controls scheduling order but not location.\n- The container still needs access to the docker daemon to get load balanced containers' configs.\n- If any trouble with haproxy not updating the config, try running reload.sh or set the `DEBUG` envvar.\n- This image is also compatible with Docker Swarm, and supports the docker native `overlay` network across multi-hosts.\n\n##### example of docker-compose.yml in 'project_dir' directory running in linux:\n\n\tversion: '2'\n\tservices:\n\t web:\n\t image: dockercloud/hello-world\n\t blog:\n\t image: dockercloud/hello-world\n\t lb:\n\t image: dockercloud/haproxy\n\t depends_on:\n\t - web\n\t - blog\n\t environment:\n\t - ADDITIONAL_SERVICES=project_dir:web,project_dir:blog\n\t volumes:\n\t - /var/run/docker.sock:/var/run/docker.sock\n\t ports:\n\t - 80:80\n\n## Configuration\n\n### Global and default settings of HAProxy\n\nSettings in this part is immutable, you have to redeploy HAProxy service to make the changes take effects\n\n|Environment Variable|Default|Description|\n|:-----:|:-----:|:----------|\n|ADDITIONAL_BACKEND_\\| |add an additional backend with the name set in . Possible values include:`balance source, server 127.0.0.1:8080`|\n|ADDITIONAL_BACKEND_FILE_\\| add an additional backend with the name set in and value of the contents of specified file.\n|ADDITIONAL_SERVICES| |list of additional services to balance (es: `prj1:web,prj2:sql`). Discovery will be based on `com.docker.compose.[project|service]` container labels. This environment variable only works on compose v2, and the referenced services must be on a network resolvable and accessible to this containers.|\n|BALANCE|roundrobin|load balancing algorithm to use. Possible values include: `roundrobin`, `static-rr`, `source`, `leastconn`. See:[HAProxy:balance](https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#4-balance)|\n|CA_CERT_FILE| |the path of a ca-cert file. This allows you to mount your ca-cert file directly from a volume instead of from envvar. If set, `CA_CERT` envvar will be ignored. Possible value: `/cacerts/cert0.pem`|\n|CA_CERT| |CA cert for haproxy to verify the client. Use the same format as `DEFAULT_SSL_CERT`|\n|CERT_FOLDER| |the path of certificates. This allows you to mount your certificate files directly from a volume instead of from envvars. If set, `DEFAULT_SSL_CERT` and `SSL_CERT` from linked services are ignored. Possible value:`/certs/`|\n|DEFAULT_SSL_CERT| |Default ssl cert, a pem file content with private key followed by public certificate, '\\n'(two chars) as the line separator. should be formatted as one line - see [SSL Termination](#ssl-termination)|\n|EXTRA_BIND_SETTINGS| |comma-separated string(`:`) of extra settings, and each part will be appended to the related port bind section in the configuration file. To escape comma, use `\\,`. Possible value: `443:accept-proxy, 80:name http`|\n|EXTRA_DEFAULT_SETTINGS| |comma-separated string of extra settings, and each part will be appended to DEFAULT section in the configuration file. To escape comma, use `\\,`|\n|EXTRA_DEFAULT_SETTINGS_FILE|File whose contents will be included in the DEFAULT section of the configuration file.|\n|EXTRA_FRONTEND_SETTINGS_\\| |comma-separated string of extra settings, and each part will be appended frontend section with the port number specified in the name of the envvar. To escape comma, use `\\,`. E.g. `EXTRA_FRONTEND_SETTINGS_80=balance source, maxconn 2000`|\n|EXTRA_FRONTEND_SETTINGS_FILE_\\|File whose contents will be appended to the frontend section with the port number specified in the filename.|\n|EXTRA_GLOBAL_SETTINGS| |comma-separated string of extra settings, and each part will be appended to GLOBAL section in the configuration file. To escape comma, use `\\,`. Possible value: `tune.ssl.cachesize 20000, tune.ssl.default-dh-param 2048`|\n|EXTRA_GLOBAL_SETTINGS_FILE|File whose contents will be included in the GLOBAL section of the configuration file.|\n|EXTRA_ROUTE_SETTINGS| |a string which is append to the each backend route after the health check, can be over written in the linked services. Possible value: \"send-proxy\"|\n|EXTRA_SSL_CERTS| |list of extra certificate names separated by comma, eg. `CERT1, CERT2, CERT3`. You also need to specify each certificate as separate env variables like so: `CERT1=\"\"`, `CERT2=\"\"`, `CERT3=\"\"`|\n|FORCE_DEFAULT_BACKEND| True | set the default_service as a default backend. This is useful when you have more than one backend and you don't want your default_service as a default backend \n|HEALTH_CHECK|check|set health check on each backend route, possible value: \"check inter 2000 rise 2 fall 3\". See:[HAProxy:check](https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#5.2-check)|\n|HTTP_BASIC_AUTH| |a comma-separated list of credentials(`:`) for HTTP basic auth, which applies to all the backend routes. To escape comma, use `\\,`. *Attention:* DO NOT rely on this for authentication in production|\n|HTTP_BASIC_AUTH_SECURE| |a comma-separated list of credentials(`:`) for HTTP basic auth, which applies to all the backend routes. To escape comma, use `\\,`. See:[HAProxy:user](https://cbonte.github.io/haproxy-dconv/1.5/configuration.html#3.4-user) *Attention:* DO NOT rely on this for authentication in production|\n|MAXCONN|4096|sets the maximum per-process number of concurrent connections.|\n|MODE|http|mode of load balancing for HAProxy. Possible values include: `http`, `tcp`, `health`|\n|MONITOR_PORT| |the port number where monitor_uri should be added to. Use together with `MONITOR_URI`. Possible value: `80`|\n|MONITOR_URI| |the exact URI which we want to intercept to return HAProxy's health status instead of forwarding the request.See: http://cbonte.github.io/haproxy-dconv/configuration-1.5.html#4-monitor-uri. Possible value: `/ping`|\n|OPTION|redispatch|comma-separated list of HAProxy `option` entries to the `default` section.|\n|RELOAD_TIMEOUT|0| When haproxy is reconfigured, a new process starts and attaches to the TCP socket for new connections, leaving the old process to handle existing connections. This timeout specifies how long the old process is permitted to continue running before being killed.
`-1`: Old process is killed immediately
`0`: No timeout, old process will run as long as TCP connections last. This could potentially be quite a while as `http-keep-alives` are enabled which will keep TCP connections open.
`>0`: Timeout in secs after which the process will be killed.\n|RSYSLOG_DESTINATION|127.0.0.1|the rsyslog destination to where HAProxy logs are sent|\n|SKIP_FORWARDED_PROTO||If set to any value, HAProxy will not add an X-Forwarded- headers. This can be used when combining HAProxy with another load balancer|\n|SSL_BIND_CIPHERS| |explicitly set which SSL ciphers will be used for the SSL server. This sets the HAProxy `ssl-default-bind-ciphers` configuration setting.|\n|SSL_BIND_OPTIONS|no-sslv3|explicitly set which SSL bind options will be used for the SSL server. This sets the HAProxy `ssl-default-bind-options` configuration setting. The default will allow only TLSv1.0+ to be used on the SSL server.|\n|STATS_AUTH|stats:stats|username and password required to access the Haproxy stats.|\n|STATS_PORT|1936|port for the HAProxy stats section. If this port is published, stats can be accessed at `http://:/`\n|TIMEOUT|connect 5000, client 50000, server 50000|comma-separated list of HAProxy `timeout` entries to the `default` section.|\n|NBPROC|1|sets the `nbproc` entry to the `global` section. By default, only one process is created, which is the recommended mode of operation.|\n|HAPROXY_USER|haproxy|sets the user of the UNIX sockets to the designated system user name|\n|HAPROXY_GROUP|haproxy|sets the group of the UNIX sockets to the designated system group name|\n\n### Settings in linked application services\n\nSettings here can overwrite the settings in HAProxy, which are only applied to the linked services. If run in Docker Cloud, when the service redeploys, joins or leaves HAProxy service, HAProxy service will automatically update itself to apply the changes\n\n|Environment Variable|Description|\n|:-----:|:----------|\n|BALANCE|load balancing algorithm to use. Possible values include: `roundrobin`, `static-rr`, `source`, `leastconn`. See:[HAProxy:balance](https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#4-balance)|\n|COOKIE|sticky session option. This needs to be set on the application service, rather than the HAProxy service. Possible value `SRV insert indirect nocache`. See:[HAProxy:cookie](http://cbonte.github.io/haproxy-dconv/configuration-1.5.html#4-cookie)|\n|DEFAULT_SSL_CERT|similar to SSL_CERT, but stores the pem file at `/certs/cert0.pem` as the default ssl certs. If multiple `DEFAULT_SSL_CERT` are specified in linked services and HAProxy, the behavior is undefined|\n|EXCLUDE_PORTS|if set, the application by the application services to the backend routes. You can exclude the ports that you don't want to be routed, like database port|\n|EXCLUDE_BASIC_AUTH|if set(any value) and `HTTP_BASIC_AUTH` global setting is set, no basic auth will be applied to this service.|\n|EXTRA_ROUTE_SETTINGS|a string which is append to the each backend route after the health check,possible value: \"send-proxy\"|\n|EXTRA_SETTINGS|comma-separated string of extra settings, and each part will be appended to either related backend section or listen session in the configuration file. To escape comma, use `\\,`. Possible value: `balance source`|\n|FAILOVER|if set(any value), it configures this service to be run as HAProxy `backup` for other configured service(s) in this backend|\n|FORCE_SSL|if set(any value) together with ssl termination enabled. HAProxy will redirect HTTP request to HTTPS request.\n|GZIP_COMPRESSION_TYPE|enable gzip compression. The value of this envvar is a list of MIME types that will be compressed. Some possible values: `text/html text/plain text/css application/javascript`. See:[HAProxy:compression](http://cbonte.github.io/haproxy-dconv/configuration-1.5.html#4-compression)|\n|HEALTH_CHECK|set health check on each backend route, possible value: \"check inter 2000 rise 2 fall 3\". See:[HAProxy:check](https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#5.2-check)|\n|HSTS_MAX_AGE|enable HSTS. It is an integer representing the max age of HSTS in seconds, possible value: `31536000`|\n|HTTP_CHECK|enable HTTP protocol to check on the servers health, possible value: \"OPTIONS * HTTP/1.1\\r\\nHost:\\ www\". See:[HAProxy:httpchk](https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#4-option%20httpchk)|\n|OPTION|comma-separated list of HAProxy `option` entries. `option` specified here will be added to related backend or listen part, and overwrite the OPTION settings in the HAProxy container|\n|SSL_CERT|ssl cert, a pem file with private key followed by public certificate, '\\n'(two chars) as the line separator|\n|TCP_PORTS|comma separated ports(e.g. 9000, 9001, 2222/ssl). The port listed in `TCP_PORTS` will be load-balanced in TCP mode. Port ends with `/ssl` indicates that port needs SSL termination.\n|VIRTUAL_HOST_WEIGHT|an integer of the weight of an virtual host, used together with `VIRTUAL_HOST`, default:0. It affects the order of acl rules of the virtual hosts. The higher weight one virtual host has, the more priority that acl rules applies.|\n|VIRTUAL_HOST|specify virtual host and virtual path. Format: `[scheme://]domain[:port][/path], ...`. wildcard `*` can be used in `domain` and `path` part|\n\nSwarm Mode only settings:\n\n|Name|Type|Description|\n|:--:|:--:|:---------:|\n|SERVICE_PORTS|envvar|comma separated ports(e.g. 80, 8080), which are the ports you would like to expose in your application service. This envvar is swarm mode only, and it is **MUST** be set in swarm mode|\n|`com.docker.dockercloud.haproxy.deactivate=`|label|when this label is set to true, haproxy will ignore the service. Could be useful for switching services on blue/green testing|\n\n\nCheck [the HAProxy configuration manual](http://cbonte.github.io/haproxy-dconv/configuration-1.5.html) for more information on the above.\n\n##### example of stackfile in Docker Cloud with settings in linked application:\n\n\tweb:\n\t image: 'dockercloud/hello-world:latest'\n\t target_num_containers: 2\n\t environment:\n - TCP_PORTS=443\n - EXCLUDE_PORTS=22\n\tlb:\n\t image: 'dockercloud/haproxy:latest'\n\t links:\n\t - web\n\t ports:\n\t - '80:80'\n\t roles:\n\t - global\n\n\n## Virtual host and virtual path\n\nBoth virtual host and virtual path can be specified in environment variable `VIRTUAL_HOST`, which is a set of comma separated urls with the format of `[scheme://]domain[:port][/path]`.\n\n|Item|Default|Description|\n|:---:|:-----:|:---------|\n|scheme|http|possible values: `http`, `https`, `wss`|\n|domain||virtual host. `*` can be used as the wildcard|\n|port|80/433|port number of the virtual host. When the scheme is `https` `wss`, the default port will be to `443`|\n|/path||virtual path, starts with `/`. `*` can be used as the wildcard|\n\n#### examples of matching\n\n|Virtual host|Match|Not match|\n|:-----------|:----|:--------|\n|http://example.com|example.com|www.example.com|\n|example.com|example.com|www.example.com|\n|example.com:90|example.com:90|example.com|\n|https://example.com|https://example.com|example.com|\n|https://example.com:444|https://example.com:444|https://example.com|\n|\\*.example.com|www.example.com|example.com|\n|\\*example.com|www.example.com, example.com, anotherexample.com|www.abc.com|\n|www.e\\*e.com|www.example.com, www.exxe.com|www.axxa.com|\n|www.example.\\*|www.example.com, www.example.org|example.com|\n|\\*|any website with HTTP||\n|https://\\*|any website with HTTPS||\n|\\*/path|example.com/path, example.org/path?u=user|example.com/path/|\n|\\*/path/|example.com/path/, example.org/path/?u=user|example.com/path, example.com/path/abc|\n|\\*/path/\\*|example.com/path/, example.org/path/abc|example.com/abc/path/\n|\\*/\\*/path/\\*|example.com/path/, example.org/abc/path/, example.net/abc/path/123|example.com/path|\n|\\*/\\*.js|example.com/abc.js, example.org/path/abc.js|example.com/abc.css|\n|\\*/\\*.do/|example.com/abc.do/, example.org/path/abc.do/|example.com/abc.do|\n|\\*/path/\\*.php|example.com/path/abc.php|example/abc.php, example.com/root/abc.php|\n|\\*.example.com/\\*.jpg|www.example.com/abc.jpg, abc.example.com/123.jpg|example.com/abc.jpg|\n|\\*/path, \\*/path/|example.com/path, example.org/path/||\n|example.com:90, https://example.com|example.com:90, https://example.com||\n\n**Note**:\n1. The sequence of the acl rules generated based on VIRTUAL_HOST are random. In HAProxy, when an acl rule with a wide scope(e.g. *.example.com) is put before a rule with narrow scope(e.g. web.example.com), the narrow rule will never be reached. As a result, if the virtual hosts you set have overlapping scopes, you need to use `VIRTUAL_HOST_WEIGHT` to manually set the order of acl rules, namely, giving the narrow virtual host a higher weight than the wide one.\n2. Every service that has the same VIRTUAL_HOST environment variable setting will be considered and merged into one single service. It may be useful for some testing scenario.\n\n## SSL termination\n\n`dockercloud/haproxy` supports ssl termination on multiple certificates. For each application that you want ssl terminates, simply set `SSL_CERT` and `VIRTUAL_HOST`. HAProxy, then, reads the certificate from the link environment and sets the ssl termination up.\n\n**Attention**: there was a bug that if an environment variable value contains \"=\", which is common in the `SSL_CERT`, docker skips that environment variable. As a result, multiple ssl termination only works on docker 1.7.0 or higher, or in Docker Cloud.\n\nSSL termination is enabled when:\n\n1. at least one SSL certificate is set, and\n2. either `VIRTUAL_HOST` is not set, or it is set with \"https\" as the scheme.\n\nTo set SSL certificate, you can either:\n\n1. set `DEFAULT_SSL_CERT` in `dockercloud/haproxy`, or\n2. set `SSL_CERT` and/or `DEFAULT_SSL_CERT` in the application services linked to HAProxy\n\nThe difference between `SSL_CERT` and `DEFAULT_SSL_CERT` is that, the multiple certificates specified by `SSL_CERT` are stored in as cert1.pem, cert2.pem, ..., whereas the one specified by `DEFAULT_SSL_CERT` is always stored as cert0.pem. In that case, HAProxy will use cert0.pem as the default certificate when there is no SNI match. However, when multiple `DEFAULT_SSL_CERT` is provided, only one of the certificates can be stored as cert0.pem, others are discarded.\n\n#### PEM Files\nThe certificate specified in `dockercloud/haproxy` or in the linked application services is a pem file, containing a private key followed by a public certificate(private key must be put before the public certificate and any extra Authority certificates, order matters). You can run the following script to generate a self-signed certificate:\n\n\topenssl req -x509 -newkey rsa:2048 -keyout key.pem -out ca.pem -days 1080 -nodes -subj '/CN=*/O=My Company Name LTD./C=US'\n\tcp key.pem cert.pem\n\tcat ca.pem >> cert.pem\n\nOnce you have the pem file, you can run this command to convert the file correctly to one line:\n\n\tawk 1 ORS='\\\\n' cert.pem\n\nCopy the output an","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",16745637,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",388961,"full_size",16739028,"id",16252900,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:bb262e7e4b5131ba8dd11a97e9c8c30a90c8093ff4219f877923e506ff26081f","features","last_pulled","2026-09-19T08:26:06.413926656Z","last_pushed","2017-10-06T13:21:41Z","os","linux","os_features","os_version","size","variant","2017-10-06T13:21:40.954321Z","last_updater","last_updater_username","media_type","1.6.7","repository",1888109,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

patricknazar/dockercloud-haproxy

Tags for patricknazar/dockercloud-haproxy