-
Notifications
You must be signed in to change notification settings - Fork 0
Settings Reference
This page documents every setting available in Nudgarr, grouped by tab. All settings are stored in /config/nudgarr-config.json and are also editable via the web UI.
| Setting | Default | Description |
|---|---|---|
| Automatic Sweeps | Off | Enables the cron-based scheduler. When off, sweeps only run when you press Run Now. |
| Cron Expression | 0 */6 * * * |
A standard 5-field cron expression defining when sweeps fire. The field is validated on change — an amber glow indicates an invalid expression. See cron syntax below. |
| Container Time | (display only) | The current container local time, shown beneath the cron field so you can confirm your schedule at a glance. Controlled by the TZ environment variable. |
Note: Nudgarr does not sweep on startup. The first sweep fires when the cron expression next matches, or immediately if you press Run Now.
Nudgarr uses standard 5-field cron: minute hour day-of-month month day-of-week
| Example | Meaning |
|---|---|
0 */6 * * * |
Every 6 hours on the clock (default) |
0 * * * * |
Every hour |
30 2 * * * |
Daily at 02:30 container time |
*/30 * * * * |
Every 30 minutes |
Use the TZ environment variable to make the schedule fire in your local timezone rather than UTC.
| Setting | Default | Description |
|---|---|---|
| Max Movies per Run | 1 |
Maximum number of Cutoff Unmet movies to search per sweep. |
| Max Episodes per Run | 1 |
Maximum number of Cutoff Unmet episodes to search per sweep. |
| Cooldown (hours) | 48 |
How long Nudgarr waits before searching the same item again. Applies to both Cutoff Unmet and Backlog searches. |
Controls the order in which eligible items are picked for searching. Set independently for Radarr and Sonarr.
| Mode | Behaviour |
|---|---|
| Random | Picks items in a random order each run (default) |
| Alphabetical | Picks items sorted A → Z by title |
| Oldest Added | Prioritises items added to your library first |
| Newest Added | Prioritises items added most recently |
Backlog settings control the optional missing-content search. Disabled by default. See Radarr & Sonarr Backlog for full details.
| Setting | Default | Description |
|---|---|---|
| Radarr Backlog | Off | Enables missing movie searches for Radarr instances |
| Radarr Missing Max | 1 |
Max missing movies to search per sweep |
| Radarr Missing Added Days | 14 |
Only search movies added at least this many days ago. 0 disables the filter. |
| Sonarr Backlog | Off | Enables missing episode searches for Sonarr instances |
| Sonarr Missing Max | 1 |
Max missing episodes to search per sweep |
| Sonarr Missing Added Days | 14 |
Only search episodes added at least this many days ago. 0 disables the filter. |
| Setting | Default | Description |
|---|---|---|
| Batch Size | 1 |
Number of items sent in a single search API call. Increasing this reduces the number of API calls but may exceed indexer limits. |
| Sleep (seconds) | 5 |
Fixed wait between batches during a sweep. |
| Jitter (seconds) | 2 |
Random additional wait added on top of sleep, up to this value. Helps avoid predictable API timing patterns. |
| State Retention (days) | 180 |
History and cooldown entries older than this are pruned. 0 disables pruning. |
| Import Check Interval (minutes) | 120 |
How often Nudgarr polls Radarr/Sonarr to confirm whether searched items were imported. Runs on its own independent timer, not tied to the sweep schedule. |
| Setting | Default | Description |
|---|---|---|
| Auth Enabled | On | Requires login before accessing the UI. Disabling removes the login screen entirely. |
| Username | (empty) | Login username |
| Password | (empty) | Login password — stored as a PBKDF2-HMAC-SHA256 hash |
| Session Duration (minutes) | 30 |
How long a login session lasts before requiring re-authentication |
If you forget your password, stop the container, delete
nudgarr-config.json, and restart — Nudgarr will re-run onboarding. You will need to re-enter all settings.
See Notifications (Apprise) for full setup instructions.
| Setting | Default | Description |
|---|---|---|
| Notifications Enabled | Off | Master toggle for all push notifications |
| Apprise URL | (empty) | One or more Apprise-format notification URLs |
| Notify on Sweep Complete | On | Send a notification after each sweep with a summary of searches and skips |
| Notify on Import | On | Send a notification when a confirmed import is detected |
| Notify on Error | On | Send a notification when a sweep or instance error occurs |