willfarrell/docker-autoheal

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

1990 stars · 264 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Docker container that monitors other containers' HEALTHCHECK status and automatically restarts those that become unhealthy. It works via the Docker socket (Unix or TCP/mTLS) and selects containers by label or watches all running containers.

Use cases

• automatically restart unhealthy docker containers
• add exit-on-unhealthy behavior docker lacks natively
• watch all containers with healthchecks and heal them
• restart only containers labeled autoheal=true
• run a self-healing sidecar in docker compose
• monitor remote docker hosts over TLS and restart unhealthy containers

When to choose

• you use Docker HEALTHCHECK but want automatic restarts on failure
• you want a lightweight, single-purpose sidecar container
• you need to manage containers on a remote Docker host over TCP/mTLS

When to avoid

• you run Kubernetes, which has built-in liveness probes and restarts
• you use an orchestrator like Docker Swarm with its own health-based rescheduling
• your containers have no HEALTHCHECK defined

Facets

service · maturity active

monitoring container-runtime deployment self-hosted monitoring self-hosted self-hosted docker healthcheck autoheal container-restart shell devops containers linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="willfarrell/docker-autoheal")