Skip to content

Navigation Menu

Sign in
Sign up
MMagTech edited this page Mar 20, 2026 · 10 revisions

Nudgarr Wiki

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 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.


Pages

Page What it covers
Setup & Configuration Docker Compose, environment variables, first run
Settings Reference Every setting explained
How Nudgarr Works Sweep lifecycle, cooldowns, scheduling
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

Quick facts

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)

Getting help

  • Bugs and feature requests — open an issue on GitHub
  • Security vulnerabilities — see SECURITY.md in the repo root

Clone this wiki locally

AltStyle によって変換されたページ (->オリジナル) /