Runs healthchecks against local docker containers.

Install as a Docker CLI plugin with a single command:

curl -fsSL https://raw.githubusercontent.com/dokku/docker-container-healthchecker/main/install.sh | sh

Or via Homebrew:

brew install dokku/repo/docker-container-healthchecker

Or build from source:

make install

See the Getting Started guide for all distribution channels (Debian/Ubuntu packages, binary downloads, etc.).

Once installed, the plugin is available via docker healthcheck.

Check a running container against healthchecks defined in app.json:

docker healthcheck check my-container

Add a default uptime healthcheck to a process type:

docker healthcheck add web

Add a listening check on a specific port:

docker healthcheck add web --listening-check --port 3000

Check if healthchecks are defined for a process type:

docker healthcheck exists web

Convert a legacy Dokku CHECKS file to app.json format:

docker healthcheck convert path/to/CHECKS --pretty

See the command reference for all flags and options.

• Getting Started -- why docker-container-healthchecker, installation, and your first healthcheck
• Command Reference -- all CLI flags and arguments
• File Format -- the app.json healthcheck schema
• Healthchecks -- check strategies, healthcheck types, and scheduler support
• Dokku Migration -- converting from the legacy CHECKS file format

MIT