Sonarr Documentation
Sonarr is an automated TV show downloading and management application. Huntarr integrates with your existing Sonarr instance to automatically search for missing episodes and quality upgrades that Sonarr doesn't actively hunt for.
Sonarr Instance Setup
Adding Your Sonarr Instance
To connect your existing Sonarr instance to Huntarr:
- Navigate to the Sonarr section in Huntarr
- Click "Add Sonarr Instance" if you don't have one configured
- Fill in your Sonarr connection details
- Test the connection to ensure Huntarr can communicate with Sonarr
Connection Settings
Configure these settings to connect Huntarr to your Sonarr instance:
| Setting | Description | Example | Notes |
|---|---|---|---|
| Name | Friendly name for this Sonarr instance | Default, TV-4K, Anime | Useful when running multiple Sonarr instances |
| URL | Base URL for your Sonarr instance | http://10.0.0.10:8989 | Include protocol (http/https) and port |
| API Key | Sonarr API key for authentication | a03c86b6292c4bd48cd5e3b84e5a470 | Found in Sonarr Settings > General > Security |
| Enabled | Whether Huntarr should process this instance | On/Off toggle | Disable to temporarily stop processing |
Search Settings
Configure how Huntarr searches for missing content and upgrades in your Sonarr instance. These settings control Huntarr's behavior when processing your TV show library.
Missing Search Mode
Determines how Huntarr searches for missing episodes:
- Season Packs: Recommended for torrent users. Searches for entire season packs first, then individual episodes
- Episodes: Searches for individual episodes only. Better for Usenet users or when you prefer single episode files
Upgrade Mode
Controls how Huntarr handles quality upgrades:
- Episodes: Upgrades individual episodes when better quality becomes available
- Seasons/Shows: Upgrades entire seasons or shows at once when better quality is found
Search Limits
Control how many items Huntarr processes per cycle to avoid overwhelming your indexers:
| Setting | Description | Recommended | Notes |
|---|---|---|---|
| Missing Search | Number of missing items to search per cycle | 2-5 | Set to 0 to disable missing searches |
| Upgrade Search | Number of episodes to upgrade per cycle | 1-3 | Set to 0 to disable upgrade searches |
| Sleep Duration | Time in seconds between processing cycles | 900 (15 min) | Longer intervals reduce indexer load |
| API Cap - Hourly | Maximum API requests per hour | 400 or less | Prevents rate limiting from indexers |
Additional Options
Fine-tune Huntarr's behavior with these additional settings:
Monitored Only
When enabled, Huntarr will only search for content that is marked as "Monitored" in Sonarr. This prevents searches for shows you've intentionally unmonitored.
Skip Future Episodes
When enabled, Huntarr will skip episodes with future air dates. This prevents unnecessary searches for content that hasn't been released yet.
Troubleshooting
Common Issues
Connection Failed
If Huntarr can't connect to your Sonarr instance:
- Verify the URL is correct and includes the protocol (http/https)
- Check that the port number is correct (default: 8989)
- Ensure the API key is copied correctly from Sonarr Settings > General > Security
- Confirm Sonarr is running and accessible from Huntarr's network
- Check firewall settings if Huntarr and Sonarr are on different machines
No Missing Content Found
If Huntarr reports no missing content but you know there are gaps:
- Ensure "Monitored Only" is configured correctly for your needs
- Check that shows are marked as "Monitored" in Sonarr
- Verify "Skip Future Episodes" isn't preventing searches for available content
- Review your Missing Search Mode setting (Season Packs vs Episodes)
API Rate Limiting
If you're getting rate limited by indexers:
- Reduce the "API Cap - Hourly" setting to a lower value
- Increase the "Sleep Duration" between processing cycles
- Lower the "Missing Search" and "Upgrade Search" limits
- Check your indexer's specific rate limits and adjust accordingly
Searches Not Triggering
If Huntarr isn't searching for content:
- Ensure the Sonarr instance is enabled in Huntarr
- Check that search limits aren't set to 0 (which disables searches)
- Verify Huntarr is running and not paused
- Review the logs for any error messages or API issues