# willfarrell/docker-autoheal

Monitor and restart unhealthy docker containers.

Repository: https://github.com/willfarrell/docker-autoheal
Canonical: https://ross.abutalabs.com/products/docker-autoheal
Language: Shell
License: MIT
License Family: permissive
Topics: docker
Last push: 2025-09-09T16:33:25+00:00

## Health v2 (maintenance only)
Score: 51/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 41, release rhythm 35, longevity 100
- inputs: {"age_days": 3490, "days_push": 358, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1990, forks 264 (observed 2026-08-28T04:06:03.085142+00:00)

## What it is
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
- artifact type: service
- maturity: active
- function: monitoring, container-runtime, deployment, self-hosted
- domain: monitoring, self-hosted
- platform: self-hosted
- tags: docker, healthcheck, autoheal, container-restart, shell, devops, containers, linux

## Member repositories
- willfarrell/docker-autoheal (main) score 51

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:03.085142+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:02:44.611749+00:00, confidence not recorded.
  - readme: https://github.com/willfarrell/docker-autoheal (fetched 2026-08-28T04:06:03.085142+00:00, sha be6b219c307b)
- Data as of 2026-08-30T08:39:29.467469+00:00.