Healarr

Healarr

Docker app from grtgbln's Repository

Overview

Health Evaluation And Library Auto-Recovery for aRR Healarr monitors your media library for corrupted files and automatically triggers re-downloads through Sonarr, Radarr, or Whisparr. It detects issues using ffprobe, MediaInfo, or HandBrake, then orchestrates the complete remediation workflow.

Requirements


        Requires mounting Sonarr, Radarr and/or Whisparr folders at same paths as in the aRR applications. See documentation: https://github.com/mescon/Healarr#docker-compose
    

Runtime arguments

Web UI
http://[IP]:[PORT:3090]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 3090

Target
3090
Default
3090
Value
3090
Enable Dry RunVariable

Enable dry run mode for testing purposes.

Target
HEALARR_DRY_RUN
Default
false|true
Retention DaysVariable

Days to keep old data. 0 to disable.

Target
HEALARR_RETENTION_DAYS
Default
90
Value
90
Max Remediation AttemptsVariable

Maximum number of remediation attempts per item.

Target
HEALARR_DEFAULT_MAX_RETRIES
Default
3
Value
3
Verification TimeoutVariable

Maximum time to wait for file replacement.

Target
HEALARR_VERIFICATION_TIMEOUT
Default
72h
Value
72h
Scan IntervalVariable

Interval between library scans.

Target
HEALARR_VERIFICATION_INTERVAL
Default
30s
Value
30s
Config FolderPath

Path to the config folder

Target
/config
Default
/mnt/user/appdata/healarr/config
Value
/mnt/user/appdata/healarr/config
Internal PortVariable

Internal port for the application. Not recommended to change.

Target
HEALARR_PORT
Default
3090
Value
3090
Internal Config DirectoryVariable

Internal config directory for the application. Not recommended to change.

Target
HEALARR_DATA_DIR
Default
/config
Value
/config
Internal Database PathVariable

Internal database path for the application. Not recommended to change.

Target
HEALARR_DATABASE_PATH
Default
/config/healarr.db
Value
/config/healarr.db
Log LevelVariable

Log level for the application.

Target
HEALARR_LOG_LEVEL
Default
info|debug|error
Base PathVariable

Base path for the application.

Target
HEALARR_BASE_PATH
Default
/
Value
/
Rate LimitVariable

Max requests/second to *arr APIs

Target
HEALARR_ARR_RATE_LIMIT_RPS
Default
5
Value
5
Rate Limit Burst SizeVariable

Burst size for *arr API rate limiting

Target
HEALARR_ARR_RATE_LIMIT_BURST
Default
10
Value
10

Details

Repository
ghcr.io/mescon/healarr:latest
Last Updated2026-05-31
First Seen2025-12-30

Run Healarr on Unraid.

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