Sonarr
Sonarr manages TV show libraries — tracking series, seasons, and episodes, and automatically searching for missing or below-cutoff content. Seekarr connects to Sonarr via its API to drive those searches on a continuous schedule.
Default port: 8989
Sonarr Instances
Go to Settings → Sonarr in the Seekarr web UI and fill in the following for each instance:
| Field | Details |
|---|---|
| URL | Base URL of your Sonarr instance, e.g. http://10.0.0.5:8989. No trailing slash. |
| API Key | In Sonarr: Settings → General → Security → API Key |
| Enabled | Toggle to enable or disable this instance without removing it. |
Click Test Connection to verify, then Save. You can add up to 9 instances per app.
Search Settings
| Setting | Default | Description |
|---|---|---|
| Missing Search Mode | episodes |
How to search for missing content: Episodes (one at a time), Season Packs (recommended for torrent users), or Shows (entire series at once). |
| Upgrade Mode | episodes |
How to search for quality upgrades: Episodes or Season Packs. |
| Missing Search | 1 |
Number of missing items to search per cycle. Set to 0 to disable missing searches entirely. |
| Upgrade Search | 0 |
Number of below-cutoff items to search for upgrades per cycle. Set to 0 to disable. |
| Sleep Duration | 900 |
Seconds between search cycles. Lower values search more frequently but increase indexer load. |
| API Cap — Hourly | 20 |
Maximum search API calls per hour. Helps prevent indexer rate limiting. Setting this too high risks account bans. |
Additional Options
| Setting | Default | Description |
|---|---|---|
| Monitored Only | Enabled | Only search for episodes marked as monitored in Sonarr. To exclude specific series or seasons from Seekarr's activity, unmonitor them in Sonarr — Seekarr will skip them entirely. |
| Skip Future Episodes | Enabled | Skip episodes whose air date is in the future to avoid unnecessary search attempts. |