Home
Because RSS sometimes needs a nudge.
Nudgarr keeps your Radarr and Sonarr libraries improving automatically — scheduling searches for missing content and quality upgrades so you don't have to.
What is Nudgarr?
Nudgarr is a self-hosted Docker application that sits alongside your existing Radarr and Sonarr instances and periodically tells them what to search for. It handles three independent pipelines:
- Cutoff Unmet — finds items that have a file but have not reached your quality profile cutoff, and tells the Arr to search for a better version. On by default.
- Backlog — searches missing movies and episodes that have never been grabbed. Off by default.
- CF Score — finds monitored files where the custom format score is below the quality profile cutoff and tells the Arr to search for a better-scored release. Off by default.
As sweeps run over time these three pipelines work together. Backlog fills in what is missing. Cutoff Unmet upgrades what you have. CF Score refines what is already good.
Nudgarr respects your indexers. Searches are rate-limited by configurable cooldowns, batch sizes, sleep timers, and jitter. Items already downloading are silently skipped so they never consume a search slot.
Pages
| Page | What it covers |
|---|---|
| Setup & Configuration | Docker Compose, environment variables, first run |
| How Nudgarr Works | Sweep lifecycle, pipelines, cooldowns, scheduling |
| Settings Reference | Every setting explained |
| Radarr & Sonarr Backlog | Backlog pipeline in depth |
| CF Score | CF Score pipeline in depth |
| Per-Instance Overrides | Per-instance search behaviour |
| Filters | Tag and quality profile filtering |
| Exclusions | Excluding titles from future searches |
| Intel | Lifetime performance dashboard |
| Notifications (Apprise) | Push notification setup and supported services |
| FAQ & Troubleshooting | Common questions and fixes |
| Glossary | Key terms used throughout the UI and docs |
Quick facts
| Current version | v4.3.0 |
| Docker Hub | mmagtech/nudgarr:latest |
| GHCR | ghcr.io/mmagtech/nudgarr:latest |
| Default port | 8085 |
| Default schedule | Every 6 hours (0 */6 * * *) |
| Data file | /config/nudgarr.db (SQLite) |
Getting help
- Bugs and feature requests — open an issue on GitHub
- Security vulnerabilities — see
SECURITY.mdin the repo root