Skip to main content

Sonarr and Radarr settings

Use Settings → Sonarr and Radarr to let upbrr match a source path against Sonarr for TV or Radarr for movies. A match supplies non-authoritative IDs, year, genres, and release-group evidence to preparation.

Configure Sonarr or Radarr​

  1. Turn on Use Sonarr and/or Use Radarr.
  2. Enter the service base URL and API key in the unnumbered fields.
  3. Use Show advanced for up to three additional URL and API-key pairs per service.
  4. Select Save.

Each instance requires both a URL and API key. Incomplete pairs are ignored. Instances are checked in this order: unnumbered, 1, 2, then 3; lookup stops when one returns useful evidence.

Use the URL reachable from the upbrr process. In Docker, localhost refers to the upbrr container, not the host or another container. Enter a base URL such as http://sonarr:8989, without adding an API route.

API keys are secrets and appear as [REDACTED] after saving.

Compatibility fields

Legacy Emby paths are retained for configuration compatibility and are not exposed in Settings.

Verify the change​

Use Test connection beside each instance to check its current draft URL and API key without saving. The read-only check does not establish that a source path will match. See connection-test behavior. Save, then prepare a source already known to the configured Arr service, then inspect its metadata and sanitized logs. A failed or empty Arr lookup does not block preparation; upbrr continues with other evidence.