wArrden makes it easy to maintain your media libraries by finding missing or upgradeable content, as well as detecting and clearing stuck imports from supported arr queues.
Caution
Images at registry.neureka.dev/warrden/warrden are no longer updated. Use ghcr.io/neurekadev/warrden.
Tip
The config.example.yaml file can look overwhelming, but you don't need to understand every option to get started. Just add your arr URL and API key, then enable the instance — the defaults handle the rest.
Download compose.yaml and .env.example.
wArrden supports multiple instances of each arr type, so you can manage separate libraries (movies, series, anime, music) independently with their own schedules and cooldowns.
| Supported | API | Queue Cleanup | Missing Search | Upgrade Search |
|---|---|---|---|---|
| Radarr | v3 |
✔️ | ✔️ | ✔️ |
| Sonarr | v3 |
✔️ | ✔️ | ✔️ |
| Lidarr | v1 |
✔️ | ✔️ | ✔️ |
| Whisparr | v3, v3-eros |
✔️ | ✔️ | ✔️ |
Every request to a configured arr instance identifies itself as wArrden/<version> through the standard HTTP User-Agent header. Blocklist detail messages remain generated by the arr and its download client; wArrden records the matched queue cleanup rule in its own Results output.
| Command | Description |
|---|---|
docker exec warrden clear-missing [instance] |
Clears all missing search cooldowns. If instance is omitted, clears across all instances. |
docker exec warrden clear-upgrades [instance] |
Clears all upgrade search cooldowns. If instance is omitted, clears across all instances. |
Periodically searches for monitored content that has never been downloaded. Limits the number of searches per run and ensures the same item isn't re-searched too often.
Periodically searches for monitored content that already exists on disk but has a better custom format score. Uses the same limits and cooldown behavior as Missing Search.
Detects stuck imports caused by common errors (wrong episode, not an upgrade, sample, corrupt file) and removes or blocklists them so the same release won't download again.
Radarr and Sonarr primarily rely on RSS feeds to detect newly uploaded releases every 15 minutes. While this works well for new uploads, many users assume it also continuously searches and reevaluates their entire library — it does not.
This creates a few common gaps in automation:
- If your server, indexers, or download clients are offline for a period of time, releases uploaded during that window may be missed entirely.
- Adding new indexers later does not retroactively search for older missing or upgradeable content. Only newly uploaded releases seen through RSS are picked up.
- Changes to Custom Formats (CFs) or scoring rules do not trigger automatic upgrades for existing media. Improved scoring only applies to future RSS releases.
Over time, this can leave libraries with permanently missing content or media that no longer matches your preferred quality and scoring standards.
wArrden fills those gaps by periodically rechecking your library and automating the cleanup work that would otherwise require manual intervention.