Skip to content

Navigation Menu

Sign in
Sign up
MMagTech edited this page Apr 10, 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 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 v5.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 によって変換されたページ (->オリジナル) /