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.

---

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.

---

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

---

The Advanced tab is split into two pages. Use the ‹ and › arrows at the top of the tab to switch between them.

Page 1 — retention, import check, log level, authentication

Page 2 — backlog nudges, auto-exclusion

Setting	Default	Description

Setting	Default	Description
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. Also triggers the auto-exclusion evaluation after each cycle — see note below.
Log Level	INFO	Nudgarr's logging verbosity — DEBUG, INFO, WARNING, or ERROR. Takes effect immediately without a container restart. Log output goes to stdout and /config/logs/nudgarr.log.

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
Auto-Exclude Movies After	0	Auto-exclude a movie after this many searches with no confirmed import. 0 disables auto-exclusion for Radarr entirely and greys out the Unexclude Days field.
Auto-Unexclude Movies After (days)	0	Automatically remove a movie from auto-exclusions after this many days, making it eligible for searching again. 0 means auto-excluded movies stay excluded until manually removed. Only active when Auto-Exclude Movies is above 0.
Auto-Exclude Shows After	0	Auto-exclude a show after this many searches with no confirmed import. 0 disables auto-exclusion for Sonarr entirely.
Auto-Unexclude Shows After (days)	0	Automatically remove a show from auto-exclusions after this many days. 0 means auto-excluded shows stay excluded until manually removed. Only active when Auto-Exclude Shows is above 0.

Import check interval and auto-exclusion: Auto-exclusion evaluates titles at the end of each import check cycle, not during the sweep. If your import check interval is longer than your cron schedule, a title may accumulate extra searches before it is evaluated. To keep auto-exclusion responsive, set the import check interval equal to or shorter than your cron 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 Auto-Exclusion	On	Send a notification when a title is auto-excluded, including the title, search count, and instance name
Notify on Error	On	Send a notification when a sweep or instance error occurs