Deutsch
English
Sortarr Setup v0.8.5.1
Add Sonarr/Radarr details and optional Plex/Jellystat/Tautulli providers. When multiple providers overlap, set your preferred media and history sources.
Effective sources: Media Auto, History Auto
Advanced settings in use: Proxy mode
Media Sources
Preferred media source
Sonarr/Radarr
Plex
Auto
Choose which source should be treated as primary when multiple media sources are configured.
If Plex is your preferred media source, Sonarr and Radarr can be left unconfigured.
Sonarr Instance 1
Instance name
Sonarr URL
Sonarr API key
Advanced Sonarr instance 1 options
Sonarr API URL (optional)
Sonarr External URL (optional)
Path map
+
Add mapping
Test connection
Advanced Sonarr instances
Sonarr Instance 2 (optional)
Instance name
Sonarr URL
Sonarr API URL (optional)
Sonarr External URL (optional)
Sonarr API key
Path map
+
Add mapping
Test connection
Sonarr Instance 3 (optional)
Instance name
Sonarr URL
Sonarr API URL (optional)
Sonarr External URL (optional)
Sonarr API key
Path map
+
Add mapping
Test connection
If you add another Sonarr instance, name all configured Sonarr instances so chips and columns stay clear.
Radarr Instance 1
Instance name
Radarr URL
Radarr API key
Advanced Radarr instance 1 options
Radarr API URL (optional)
Radarr External URL (optional)
Path map
+
Add mapping
Test connection
Advanced Radarr instances
Radarr Instance 2 (optional)
Instance name
Radarr URL
Radarr API URL (optional)
Radarr External URL (optional)
Radarr API key
Path map
+
Add mapping
Test connection
Radarr Instance 3 (optional)
Instance name
Radarr URL
Radarr API URL (optional)
Radarr External URL (optional)
Radarr API key
Path map
+
Add mapping
Test connection
If you add another Radarr instance, name all configured Radarr instances so chips and columns stay clear.
History and optional playback providers
Playback History Sources
Preferred history source
Auto
Tautulli
Jellystat
Plex
When multiple history providers are configured, this preference decides which one is used for watch stats/matching.
Jellystat (optional)
Jellystat URL
Jellystat API key
Jellystat library IDs (Sonarr)
Jellystat library IDs (Radarr)
Test connection
Leave library IDs blank to auto-detect by library type.
You can configure multiple history sources. Use Preferred history source above to pick which provider should win when more than one is available.
Tautulli (optional)
Tautulli URL
Tautulli API key
Test connection
Playback Providers
Plex (optional)
Plex URL
Plex Token
Plex section IDs (optional)
Test connection
Leave section IDs blank to scan all libraries.
Security
Basic auth username
Basic auth password
Clear existing password
Leave blank to keep current password when a password is already configured.
Credentials are stored via the configured secret backend. Protect your config directory and credential store.
Connection test buttons stay disabled until Basic Auth is configured and security setup is complete. Saving settings still validates configured connections.
Proxy mode
Direct (no reverse proxy)
Single proxy (recommended)
Two proxies (for example Cloudflare + Traefik)
Custom
Choose the proxy chain in front of Sortarr. Use Custom only if you need per-header hop overrides.
Secret storage
Storage backend: Secret files
This install stores secrets as files under your config directory and keeps only `*_FILE` references in the env file.
Secret files directory: /data/secrets
Session secret key
Generate permanent secret key
Used for session and CSRF signing. Keep this stable, and use the same value on every replica.
Sortarr generated a temporary session secret at startup. Save a persistent Session secret key to avoid CSRF/session issues after restart or across replicas.
Advanced settings
Network & CSRF
Proxy hops
Proxy hops (X-Forwarded-For)
Proxy hops (X-Forwarded-Host)
Proxy hops (X-Forwarded-Proto)
Proxy hops (X-Forwarded-Port)
Proxy hops (X-Forwarded-Prefix)
CSRF trusted origins (optional)
Waitress trusted proxy (optional)
Set this to the immediate proxy IP/host in front of Sortarr when known. Changes apply after restart. Leave blank only if wildcard proxy trust is intentional.
Run proxy/CSRF diagnostics
What to do if diagnostics report a mismatch:
1) Set Proxy mode to the suggested value and save.
2) Ensure your proxy sends `X-Forwarded-Proto` and `X-Forwarded-Host`.
3) Refresh Setup and run diagnostics again.
Recovery mode (unsafe): allow startup without a persistent Session secret key
Use recovery mode only if you are locked out. This weakens session/CSRF reliability and should be turned off after you save a persistent Session secret key.
Arr performance
Sonarr timeout seconds
Sonarr episode file workers
Radarr timeout seconds
Radarr wanted workers
Radarr instance workers
Leave fields blank for defaults. Timeout seconds accept 0 to disable. Radarr wanted workers are capped at 4.
Tautulli performance
Tautulli timeout seconds
Tautulli fetch seconds
Tautulli metadata workers
Metadata lookups are enforced as unlimited for accuracy. Leave fields blank for defaults; seconds fields accept 0 for no time limit.
Plex settings
Plex client identifier (optional)
Plex history page size
History page size controls how many Plex history rows are fetched per request. Leave blank for defaults.
Env file path: /data/Sortarr.env
Save and continue