Sortarr Setup v0.8.9
Choose your media-info source, then your history source, then add playback and enrichment providers only where they add value. Optional connections can still be added alongside the main path when needed.
Effective sources: Media Auto, History Auto
Step 1 Media info source Action needed Choose your media info source
Start by choosing what Sortarr should use for media info. The setup will focus on that path first, and you can add other providers later if you need them.
Media source intent
Choose the system that should drive your media library view in Sortarr.
This choice controls which setup fields are shown first. If you use Sonarr and Radarr for media info, you can still configure Plex or Jellyfin in Step 2 for history use and Step 3 for playback enrichment.
Sonarr and Radarr connections
Use these fields when Sonarr and Radarr are your media source, or add them alongside Plex or Jellyfin if you want those connections available too.
Sonarr Instance 1
Advanced Sonarr instance 1 options
Radarr Instance 1
Advanced Radarr instance 1 options
Step 4 Protect access Needs attention Choose authentication and save a secret key
Choose how users authenticate, set the proxy mode, and save a persistent session secret key before continuing into the app.
Security
Pick who handles login. Use Basic when Sortarr should prompt for credentials. Use External only when your trusted reverse proxy already handles login.
Leave blank and keep this unchecked to keep the current password. Enter a new password to replace it. Check this only if you intentionally want to remove the saved password.
Credentials are stored via the configured secret backend. Protect your config directory and credential store.
Connection test buttons stay disabled until authentication is configured and security setup is complete. Saving settings still validates configured connections.
Choose the proxy chain in front of Sortarr. Use Custom only if you need per-header hop overrides.
Used for session and CSRF signing. Keep this stable, and use the same value on every replica. Leave it blank to let Sortarr generate and persist one when you save, or enter your own value now if you want to control it.
Sortarr generated a temporary session secret at startup. Saving this form will persist a stable secret automatically unless you enter or generate one here first.
Step 5 Advanced network and performance Optional No advanced overrides
Use this section for secret-storage details, proxy trust, CSRF diagnostics, and performance overrides. Most setups should be able to save successfully without changing anything here.
Advanced settings in use: None
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: /app/secrets
Advanced settings
Network & CSRF
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.
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.
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
Leave fields blank for defaults. Timeout seconds accept 0 to disable. Radarr wanted workers are capped at 4.
Tautulli performance
Metadata lookups are enforced as unlimited for accuracy. Leave fields blank for defaults; seconds fields accept 0 for no time limit.
Streamystats performance
These values control Streamystats search and detail requests during playback-history matching. Leave fields blank for defaults.
Plex settings
History page size controls how many Plex history rows are fetched per request. Leave blank for defaults.
Step 2 History source Optional Choose your history source
Choose which system should provide watch history and playback-history data. Playback and enrichment connections live in the next step so they can stay separate from your primary history choice.
History source intent
Choose the provider that should drive watch history, playback-history stats, and matching in Sortarr.
Auto lets Sortarr use what is already configured. Pick a specific provider when you want this step to focus on one history path.
If Plex is already configured in Step 1, Sortarr can reuse that connection here as your history source. For Jellyfin-backed watch history, use Jellystat or Streamystats instead of native Jellyfin history selection.
Jellystat
Leave library IDs blank to auto-detect by library type.
Streamystats
Sortarr uses the Streamystats API key plus a Jellyfin user login to search and load item details. Leave server ID blank to auto-detect when only one server is configured.
Tautulli
You can still add both history providers here. The selected provider stays in focus, and the other one remains available if you explicitly add it.
Step 3 Playback and enrichment providers Optional No playback providers connected
Connect Plex or Jellyfin here when you want playback enrichment, mismatch features, and provider-specific insights, even if a different system is your primary history source.
Playback and enrichment providers
Playback and enrichment providers can still be useful when they are not your primary history source. This is where Sortarr learns about Plex- or Jellyfin-specific playback features and insights.
Choose which provider should drive provider-specific insights and enrichment when both Plex and Jellyfin are configured. Auto follows the active history provider first, then falls back to the current media source.
If Step 2 uses Plex as the history source, the same connection from this step will be reused automatically unless Step 1 already owns it as your media source.
Plex
Leave section IDs blank to scan all libraries.
Jellyfin
Leave library IDs blank to auto-detect by library type.
Env file path: /app/.env