Huntarr-Sonarr

Overview

DEPRECATED: Use Huntarr instead.
Huntarr (Sonarr Edition) continually searches your Sonarr library for shows with missing episodes and episodes that need quality upgrades. It automatically triggers searches for both missing episodes and episodes below your quality cutoff. It's designed to run continuously while being gentle on your indexers, helping you gradually complete your TV show collection with the best available quality.

Requirements

Requires a separate Sonarr v5 instance.

Runtime arguments

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

Template configuration

Enable Web UIVariable

Enable the web UI for Huntarr

Target: ENABLE_WEBUI
Default: true|false

Web UI PortPorttcp

Container Port: 8988

Target: 8988
Default: 8988
Value: 8988

Sonarr - URLVariable

URL of your Sonarr instance

Target: API_URL
Default: http://localhost:8989
Value: http://localhost:8989

Sonarr - API KeyVariable

API key for your Sonarr instance

Target: API_KEY

Sonarr - Monitored OnlyVariable

Only process monitored shows and episodes

Target: MONITORED_ONLY
Default: true|false

Sonarr - Skip Future Episodes

Skip processing episodes with release dates in the future

Target: SKIP_FUTURE_EPISODES
Default: true|false

Sonarr - Skip Metadata RefreshVariable

Skip refreshing metadata for series before searching.

Target: SKIP_SERIES_REFRESH
Default: true|false

Huntarr - Missing Shows Per CycleVariable

Maximum missing shows to process per cycle. Set to 0 to disable.

Target: HUNT_MISSING_SHOWS
Default: 1
Value: 1

Huntarr - Upgrade Episodes Per CycleVariable

Maximum upgrade episodes to process per cycle. Set to 0 to disable.

Target: HUNT_UPGRADE_EPISODES
Default: 0
Value: 0

Huntarr - Use Random Selection for MissingVariable

Use random selection for processing missing shows if enabled, or sequential if disabled.

Target: RANDOM_MISSING
Default: true|false

Huntarr - Use Random Selection for UpgradeVariable

Use random selection for processing upgrade episodes if enabled, or sequential if disabled.

Target: RANDOM_UPGRADES
Default: true|false

Config DataPath

Path to config data

Target: /config
Default: /mnt/user/appdata/huntarr-sonarr/config
Value: /mnt/user/appdata/huntarr-sonarr/config

Sonarr - API TimeoutVariable

Timeout for API requests in seconds.

Target: API_TIMEOUT
Default: 60
Value: 60

Huntarr - Sleep DurationVariable

Duration, in seconds, to wait between cycles.

Target: SLEEP_DURATION
Default: 900
Value: 900

Huntarr - Reset IntervalVariable

Interval, in hours, after which to reset the processed state files. Set to 0 to disable.

Target: STATE_RESET_INTERVAL_HOURS
Default: 168
Value: 168

Huntarr - Minimum Queue SizeVariable

Minimum number of items in the download queue before starting a hunt. Set to -1 to disable.

Target: MINIMUM_DOWNLOAD_QUEUE_SIZE
Default: -1
Value: -1

Debug ModeVariable

Enable debug mode for detailed logging.

Target: DEBUG_MODE
Default: false|true

Command Status - Wait TimeVariable

Delay in seconds between checking for command status

Target: COMMAND_WAIT_DELAY
Default: 1
Value: 1

Command Status - Max AttemptsVariable

Maximum number of attempts to check for command status

Target: COMMAND_WAIT_ATTEMPTS
Default: 600
Value: 600

Links

Template Support Docker Hub Project

Details

Repository

huntarr/4sonarr:latest

Registry

https://hub.docker.com/r/huntarr/4sonarr

Last Updated2025-04-23

First Seen2025-04-07

Run Huntarr-Sonarr on Unraid.

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

Explore Unraid OS