Skip to content

Library and Subtitles ​

Sonarr manages television, Radarr manages movies, Bazarr manages subtitle providers, and SubGen supplies local Whisper transcription. All four run in /docker/servarr.

Prepare the media server host and shared Servarr project before following these application steps. Exact lab accounts, secrets, and AI procedures are in the internal companion.

Access ​

ApplicationDomainDirect access
Sonarrsonarr.home.rwk.mehttp://10.120.40.105:8989
Radarrradarr.home.rwk.mehttp://10.120.40.105:7878
Bazarrbazarr.home.rwk.mehttp://10.120.40.105:6767
SubGenNo proxy hostnameInternal http://subgen:9000 only

SubGen has no published host port. Bazarr can reach its service name because they share servarrnetwork.

Configure Sonarr and Radarr ​

Start the dependencies using the shared deployment guide and open each manager's dashboard. Set an application login and keep API keys private. Retrieve the API keys from Settings → General → Security for Seerr, Prowlarr, Bazarr, and Unpackerr.

  1. Add a root folder for organized media: /data/tv in Sonarr and /data/movies in Radarr are example paths. Downloads belong in a separate directory, not inside these roots.
  2. Choose quality profiles and size limits appropriate to the clients and storage. Select monitoring behavior for new items, seasons, and future releases deliberately.
  3. Configure media naming and completed-download handling. Keep the same /data view across managers, torrent client, and extraction helper.
  4. Add the download clients below and test each connection.
  5. Configure Prowlarr's application connections using the indexer guide, then test a representative search and import.

Download-client endpoints ​

The clients share Gluetun's namespace. From a manager in this deployment, use Gluetun's Docker service name and the container-side client ports:

ClientHostPortContainer download path
qBittorrentgluetun8081/data/downloads/completed
SABnzbdgluetun8080/downloads/sabnzbd

Enter the application's credentials or API key and assign distinct categories, for example tv for Sonarr and movies for Radarr. Match those categories in each client so completed jobs are attributed to the correct manager. Internal ports differ from the host's published 8080 and 8085.

SABnzbd sees the host's downloads directory as /downloads; the managers see it as /data/downloads. If SABnzbd reports an unmapped path, configure a remote path mapping in the manager for the SABnzbd host, translating /downloads/ to /data/downloads/. Verify the exact path in a completed job rather than adding unrelated path mappings. qBittorrent and the managers already share /data and normally need no remapping.

Verify imports ​

Add a small representative item, check that it reaches the intended client/category, and inspect the manager's activity queue. A successful download is not a successful import: confirm the destination file, library scan, and Jellyfin playback. If an import fails, compare paths, permissions, free space, and reported client state before retrying or changing root folders.

Configure Bazarr ​

Open Bazarr and secure its dashboard. Enable Sonarr and Radarr integration:

IntegrationInternal endpoint
Sonarrhttp://sonarr:8989
Radarrhttp://radarr:7878

These names resolve to the managers on the shared Docker network, independently of their bridge IP addresses. Add each manager's API key and test connectivity. Because Bazarr and the managers share /data, matching media paths should not require an additional mapping.

Configure subtitle providers and their accounts, then create language profiles and assign them to the media you want processed. This lab uses an English language filter/profile; choose your own language and hearing-impaired/forced-subtitle preferences. Test provider access and a manual subtitle download before scheduling library-wide work.

Configure SubGen transcription ​

The shared Compose definition uses the CPU-only SubGen image with one concurrent transcription, a medium Whisper model, eight CPU threads, an eight-CPU limit, and an 8 GiB memory limit. It mounts media read-only and caches models in /docker/servarr/subgen/models. Bazarr writes the subtitle returned by the API.

The model is downloaded on the first transcription, so allow internet access, disk space, and sufficient RAM. On a smaller machine, reduce SUBGEN_WHISPER_MODEL, threads, and resource limits before starting. The configured initial_prompt encourages punctuation; it does not provide reliable speaker identification or dialogue dashes.

In Bazarr:

  1. Enable Deep analyze media file to get audio tracks language so the desired audio track can be selected.
  2. Add the Whisper provider with endpoint http://subgen:9000 and enable Pass Video Name.
  3. Allow a transcription timeout of at least 3600 seconds for this CPU workflow.
  4. Leave automated Whisper fallback disabled initially. Request a subtitle through an episode's manual search and select the Whisper result.
  5. If automatic audio synchronization is enabled, exclude provider whisperai because SubGen already supplies synchronized timing.

Check API health without triggering model download or transcription:

sh
cd /docker/servarr
docker compose ps sonarr radarr bazarr subgen
docker exec bazarr curl --fail --silent --show-error http://subgen:9000/status

Then transcribe one representative episode and check language selection, text, timing, runtime, and host load. Do not enable automatic processing of an entire library before this test is satisfactory.

Configure HTTPS access ​

In Cloudflare-managed DNS, resolve these names to Nginx Proxy Manager at 10.120.40.101. Use DNS-only records, certificates covering the names, and access policies appropriate to your clients. These are private network services, reachable through allowed local networks or approved Tailscale access. This setup does not require WAN port forwarding for the service names.

DomainProxy backendWebSockets
sonarr.home.rwk.mehttp://10.120.40.105:8989Not required
radarr.home.rwk.mehttp://10.120.40.105:7878Not required
bazarr.home.rwk.mehttp://10.120.40.105:6767Not required

For another homelab, replace the addresses and domain consistently. Configure the application's own authentication and direct-backend network policy too. See Nginx Proxy Manager for DNS, certificates, and proxy configuration.

Maintenance and recovery ​

Keep Sonarr, Radarr, and Bazarr configuration on local storage and include them in consistent application backups. SubGen's model cache is replaceable; retain its configured model and resource choices. Protect API keys and provider accounts in your secret manager.

Use scoped Compose commands for a selected service, and verify a search, import, subtitle, and playback after updates. Preserve existing roots and categories during a rebuild and restore matching application/database versions before allowing automated work to resume. The deployment sources remain in servers/media-server/servarr in the homelab repository.