Rangarr
Docker app from JudoChinX's Repository
Overview
Rangarr is a lightweight orchestration service that automates and staggers media searches across multiple *arr instances (Radarr, Sonarr, Lidarr). It helps keep your library complete without overwhelming your indexers or API limits.
Features:
- Multi-Instance Support: Manage Radarr, Sonarr, and Lidarr from a single service.
- Smart Staggering: Prevents "thundering herd" issues by spacing out search requests.
- Proportional Interleaving: Balanced searching between missing items and upgrades.
- Weighted Distribution: Prioritize specific instances.
- No Telemetry: Only communicates with the *arr instances you configure.
Note: By default, this template is configured using environment variables. You can also use a config.yaml by mapping the /app/config path and changing RANGARR_CONFIG_SOURCE to "file".
Runtime arguments
- Network
bridge- Privileged
- false
Template configuration
Set to 'env' to use environment variables or 'file' to use a config.yaml mount.
- Target
- RANGARR_CONFIG_SOURCE
- Default
- env
- Value
- env
How often to run the search cycle (e.g., 3600 for every hour).
- Target
- RANGARR_GLOBAL_INTERVAL
- Default
- 3600
- Value
- 3600
If true, Rangarr will log what it would search without actually triggering the search.
- Target
- RANGARR_GLOBAL_DRY_RUN
- Default
- false
- Value
- false
Seconds to wait between individual search requests.
- Target
- RANGARR_GLOBAL_STAGGER_INTERVAL_SECONDS
- Default
- 30
- Value
- 30
Max missing items to search per cycle (0 = disabled, -1 = unlimited).
- Target
- RANGARR_GLOBAL_MISSING_BATCH_SIZE
- Default
- 20
- Value
- 20
Max upgrade-eligible items to search per cycle (0 = disabled, -1 = unlimited).
- Target
- RANGARR_GLOBAL_UPGRADE_BATCH_SIZE
- Default
- 10
- Value
- 10
Set your timezone for log timestamps.
- Target
- TZ
- Default
- UTC
- Value
- UTC
Set the log level (DEBUG, INFO, WARNING, ERROR).
- Target
- LOG_LEVEL
- Default
- INFO
- Value
- INFO
Priority for choosing items (alphabetical_ascending, alphabetical_descending, last_added_ascending, last_added_descending, last_searched_ascending, last_searched_descending, random, release_date_ascending, release_date_descending).
- Target
- RANGARR_GLOBAL_SEARCH_ORDER
- Default
- last_searched_ascending
- Value
- last_searched_ascending
Days to wait before searching the same item again (0 to disable).
- Target
- RANGARR_GLOBAL_RETRY_INTERVAL_DAYS
- Default
- 30
- Value
- 30
Comma-separated list of *arr tag names to include. Only items with at least one matching tag will be searched. Leave blank to include all items.
- Target
- RANGARR_GLOBAL_INCLUDE_TAGS
Comma-separated list of *arr tag names to exclude. Items with any matching tag will be skipped. Leave blank to exclude nothing.
- Target
- RANGARR_GLOBAL_EXCLUDE_TAGS
Display name for this instance.
- Target
- RANGARR_INSTANCE_0_NAME
Must be 'radarr'.
- Target
- RANGARR_INSTANCE_0_TYPE
- Default
- radarr
- Value
- radarr
URL to your Radarr instance (use Docker IP or hostname).
- Target
- RANGARR_INSTANCE_0_URL
- Default
- http://radarr:7878
- Value
- http://radarr:7878
Your Radarr API Key.
- Target
- RANGARR_INSTANCE_0_API_KEY
Display name for this instance.
- Target
- RANGARR_INSTANCE_1_NAME
Must be 'sonarr'.
- Target
- RANGARR_INSTANCE_1_TYPE
- Default
- sonarr
- Value
- sonarr
URL to your Sonarr instance (use Docker IP or hostname).
- Target
- RANGARR_INSTANCE_1_URL
- Default
- http://sonarr:8989
- Value
- http://sonarr:8989
Your Sonarr API Key.
- Target
- RANGARR_INSTANCE_1_API_KEY
If true, Sonarr will search for missing/upgrade items as season packs when multiple episodes are needed.
- Target
- RANGARR_GLOBAL_SEASON_PACKS
- Default
- false
- Value
- false
Display name for this instance.
- Target
- RANGARR_INSTANCE_2_NAME
Must be 'lidarr'.
- Target
- RANGARR_INSTANCE_2_TYPE
- Default
- lidarr
- Value
- lidarr
URL to your Lidarr instance (use Docker IP or hostname).
- Target
- RANGARR_INSTANCE_2_URL
- Default
- http://lidarr:8686
- Value
- http://lidarr:8686
Your Lidarr API Key.
- Target
- RANGARR_INSTANCE_2_API_KEY
Mount point for config.yaml (only needed if RANGARR_CONFIG_SOURCE is 'file').
- Target
- /app/config
- Default
- /mnt/user/appdata/rangarr
- Value
- /mnt/user/appdata/rangarr
Download Statistics
Details
judochinx/rangarr:latestRun Rangarr on Unraid.
Rangarr is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.