binhex-healarr

Overview

Healarr monitors Docker containers for unhealthy status and automatically performs configurable actions (restart, stop, etc.) with retry logic to prevent false positives. It supports filtering by container label, environment variable, or name, and includes comprehensive logging.

Runtime arguments

Network: bridge
Shell: bash
Privileged: false
Extra Params: --restart=unless-stopped

Template configuration

Path: /configPathrw

This is the container path to your configuration files, e.g. databases, configuration files, logs etc.

Target: /config
Default: /mnt/user/appdata/healarr

Path: /var/run/docker.sockPathrw

Docker socket for container management - REQUIRED if not using DOCKER_HOST. Remove this if using Docker socket proxy.

Target: /var/run/docker.sock
Default: /var/run/docker.sock

Variable: DOCKER_HOSTVariable

Docker socket proxy address (e.g. 'tcp://dockersocket:2375'). Use this as a secure alternative to mounting /var/run/docker.sock. Leave empty to use direct socket mount.

Target: DOCKER_HOST

Variable: MONITOR_INTERVALVariable

Time in seconds between checking for containers that are 'unhealthy' (default: 60).

Target: MONITOR_INTERVAL
Default: 60

Variable: RETRY_COUNTVariable

Number of times to verify unhealthy status before taking action (default: 3).

Target: RETRY_COUNT
Default: 3

Variable: RETRY_DELAYVariable

Time in seconds to wait between retry health checks (default: 10).

Target: RETRY_DELAY
Default: 10

Variable: ACTIONVariable

Docker action to execute on unhealthy containers: restart, stop, pause, unpause, kill or none (no action).

Target: ACTION
Default: restart|stop|pause|unpause|kill|none

Variable: CONTAINER_LABELVariable

Filter containers by label (e.g. 'com.example.monitor=true'). Filters use OR logic.

Target: CONTAINER_LABEL

Variable: CONTAINER_ENV_VARVariable

Filter containers by environment variable (e.g. 'MONITOR_ENABLED=true'). Filters use OR logic.

Target: CONTAINER_ENV_VAR

Variable: CONTAINER_NAMEVariable

Filter containers by name, comma-separated (e.g. 'sonarr,radarr,plex'). Filters use OR logic.

Target: CONTAINER_NAME

Variable: APPRISE_NOTIFICATION_SERVICESVariable

Comma-separated list of Apprise service URLs for notifications (e.g. 'mailto://user:pass@gmail.com,discord://webhook_id/webhook_token').

Target: APPRISE_NOTIFICATION_SERVICES

Variable: LOG_LEVELVariable

Logging level: 0=DEBUG, 1=INFO, 2=WARN, 3=ERROR (default: 1).

Target: LOG_LEVEL
Default: 1

Variable: ENABLE_HEALTHCHECKVariable

Enable or disable healthchecks (this container).

Target: ENABLE_HEALTHCHECK
Default: yes|no

Variable: HEALTHCHECK_COMMANDVariable

The command or script to execute, if not specified then the script healthcheck.sh will be used (process, dns and https checking).

Target: HEALTHCHECK_COMMAND

Variable: HEALTHCHECK_ACTIONVariable

The action to execute if the healthcheck command returns a non zero exit code, if not specified the action will be 'exit 1', if you want the container to exit on failure then set the action to 'kill 1'.

Target: HEALTHCHECK_ACTION

Variable: HEALTHCHECK_HOSTNAMEVariable

The hostname used when performing HTTPS and DNS healthchecking.

Target: HEALTHCHECK_HOSTNAME
Default: google.com

Variable: PUIDVariable

User ID for the running container

Target: PUID
Default: 99

Variable: PGIDVariable

Group ID for the running container

Target: PGID
Default: 100

Variable: UMASKVariable

UMASK for the running container

Target: UMASK
Default: 000

Links

Template Support Registry Project

Details

Repository

ghcr.io/binhex/arch-healarr

Registry

https://github.com/binhex/arch-healarr/pkgs/container/arch-healarr

Last Updated2026-01-07

First Seen2025-12-29

Run binhex-healarr on Unraid.

binhex-healarr is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS