Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A Docker app that checks the HTTP status of linked containers. Will automatically poll all linked containers that expose port 80, and will respond to HTTP requests with a 200 status if all linked containers are OK or a 500 otherwise.

This is designed to be used, for example, with AWS ELB health checks to determine if any application has failed on instances which are running multiple web apps in Docker containers.

The app exposes port 80, so the idea is to make this app the default in Nginx (or whatever you're using) if no hostname is specified.


docker run -d --link app1:app1 --link app2:app2 zooniverse/docker-status

Configuration can be done with environment variables:

docker run -d --link app1:app1 -e "APP1_GET_PATH=/status" -e "HTTP_TIMEOUT=15" zooniverse/docker-status

Valid options are:

  • [NAME]_GET_PATH – What path to get when testing the container NAME. Default: / If your app runs on a port other than 80, you can reference the port in the path, like so: [NAME]_GET_PATH: :8080/

  • [NAME]_CONNECT_IP - Whether or not to use the IP address from the Docker environment variables rather than the host name when connecting. Default: false

  • HTTP_TIMEOUT – How many seconds to wait for each container to respond before assuming it has failed. Default: 30

  • TEST_INTERVAL – How often to test linked containers (in seconds). Default: 30

  • LISTEN_HOST – Which IP address to listen on. Leave this alone unless you're doing something interesting with the --net option to docker run. Default: all (

  • LISTEN_PORT – Which port to listen on. Make sure to also expose the port if you change this. Default: 80

  • DEBUG – Run Flask in debug mode. Default: false

  • DELAY_START – Start one test process every TEST_INTERVAL, rather than all at once. Default : false

  • GRAYLOG_HOST - Host to send GELF logs to. Default: none

  • GRAYLOG_PORT - Port to send GELF lgos to. Default: 12201

  • GRAYLOG_LOCALNAME - Localname for log entries (shows up as "source" in Graylog"). Default: docker-status


A Docker app that checks the HTTP status of linked containers




No releases published


No packages published