-
Notifications
You must be signed in to change notification settings - Fork 0
Home
MMagTech edited this page Mar 15, 2026
·
10 revisions
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.
Nudgarr is a self-hosted Docker application that sits alongside your existing Radarr and Sonarr instances and periodically triggers searches on your behalf. It handles two distinct jobs:
- Cutoff Unmet — finds items in Radarr/Sonarr's Wanted → Cutoff Unmet queue and triggers a search for a better quality version
- Backlog Nudges — searches missing movies and episodes that have never been grabbed, with configurable age filtering and per-app caps
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.
| Page | What it covers |
|---|---|
| Setup & Configuration | Docker Compose, environment variables, first run |
| Settings Reference | Every setting explained |
| How Nudgarr Works | Sweep lifecycle, cooldowns, scheduling |
| Per-Instance Overrides | Independent settings per instance for multi-instance setups |
| Radarr & Sonarr Backlog | Backlog Nudge feature in depth |
| Exclusions | Excluding titles from future searches |
| Notifications (Apprise) | Push notification setup and supported services |
| FAQ & Troubleshooting | Common questions and fixes |
| Glossary | Key terms used throughout the UI and docs |
| Current version | v4.0.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) |
- Bugs and feature requests — open an issue on GitHub
-
Security vulnerabilities — see
SECURITY.mdin the repo root