# Autoheal

Autoheal is a self-hosted infrastructure app. Monitor and restart unhealthy docker containers. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/343/autoheal

## Description

Monitor and restart unhealthy docker containers. This functionality was proposed to be included with the addition of HEALTHCHECK, however didn't make the cut. This container is a stand-in till there is native support for --exit-on-unhealthy

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

43/100 (Fair), based on 3 of 4 factors.
- Maintained: 32 (last commit 408 days ago)
- Popular: 66 (2,012 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/willfarrell/autoheal
- Unraid: https://ca.unraid.net/apps/autoheal-0t20dwf18qzw1n?q=autoheal

## Common questions

### What file system mount does docker-autoheal need to restart containers?

It needs the Docker socket mounted at /var/run/docker.sock so it can see and restart containers. This is powerful access, so run autoheal only on a trusted machine.

### Which containers will autoheal monitor and restart?

A container must have the label set by AUTOHEAL_CONTAINER_LABEL, such as autoheal: true. It also needs a Docker healthcheck, because autoheal leaves containers without one alone.

### How can I stop autoheal from restarting a container that is still starting up?

Set AUTOHEAL_START_PERIOD to a few seconds or more if the service boots slowly. This prevents autoheal from checking before the container has finished starting.

### How do I use Apprise with docker-autoheal?

Configure Apprise according to the autoheal documentation so autoheal can use it. Apprise also needs a functional healthcheck for autoheal to determine whether it needs to be restarted.

---
Source: Our Local Host (https://ourlocalhost.com/app/343/autoheal), the self-hosted and open-source app directory.