Skip to content

Downloads and Indexers ​

Gluetun provides VPN networking for qBittorrent, SABnzbd, Prowlarr, and FlareSolverr. Unpackerr handles archived torrent extraction, while deunhealth provides selected unhealthy-container recovery.

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 and ports ​

ServiceDomainDirect host accessShared internal endpoint
qBittorrenttorrent.home.rwk.mehttp://10.120.40.105:8080gluetun:8081
SABnzbdsab.home.rwk.mehttp://10.120.40.105:8085gluetun:8080
Prowlarrprowlarr.home.rwk.mehttp://10.120.40.105:9696gluetun:9696
FlareSolverrNoneNot publishedhttp://127.0.0.1:8191 from its shared namespace
UnpackerrNoneNot publishedContainer loopback health endpoint

The internal service names resolve on the Servarr Docker network and remain stable across bridge-address changes. Browser clients use the HTTPS hostnames after proxy setup. The download-client connection settings used by managers use the internal ports, not the host-side port numbers.

Configure Gluetun ​

Use the shared Compose and environment example. Enter your provider's WireGuard private key and tunnel address, supported provider name, and chosen server region. This lab uses Surfshark and Canada. Those credentials are unrelated to the host's SSH key or LAN address.

Gluetun needs /dev/net/tun and the NET_ADMIN capability to establish the tunnel and its firewall. Its consumers use network_mode: service:gluetun; their ports are published on Gluetun rather than individually. Sonarr, Radarr, Bazarr, SubGen, Streamystats, and Unpackerr use the regular Docker network.

Start the project dependencies and check Gluetun before configuring downloads:

sh
cd /docker/servarr
docker compose ps gluetun
docker exec gluetun wget -qO- https://ipinfo.io/ip

The observed egress should match the intended VPN connection, not the home's normal internet egress. The four namespace consumers share that connection. A successful ping health check alone does not prove the intended exit location or absence of leaks; validate the provider connection and application-specific behavior too.

Configure qBittorrent ​

Open its dashboard and retrieve the initial generated password from local container logs if the installed release requires it. Keep logs private, then immediately set your own WebUI login under Settings → WebUI → Authentication.

In Settings → Downloads, configure:

OptionValue
Default Save Path/data/downloads/completed
Incomplete torrents/data/downloads/incomplete
Copy .torrent files/data/downloads/torrents

Create the corresponding host directories as described in the overview. In advanced settings, select tun0 as the network interface so transfers are tied to the VPN device. Verify normal download behavior after a provider reconnect using a controlled test, without changing the whole network simply to test it.

TCP/UDP 6881 is not published on the Ubuntu host. Incoming torrent reachability, where supported, belongs to the VPN provider's forwarding capabilities and tunnel configuration; adding a host LAN listener is not equivalent to provider port forwarding.

Exported .torrent files can accumulate independently of the media payload. An optional cleanup job may remove only those exported metadata files after a chosen retention period. This lab retains them for 30 days and runs a mount-guarded cleanup daily; exact automation belongs in the internal runbook. Do not apply that cleanup to downloaded media or original seeding directories.

Configure SABnzbd ​

Open its dashboard and complete the setup wizard with your Usenet provider's server, port, encryption, and credentials. Test the server connection, set a unique dashboard login, and keep its API key private.

The host's media downloads directory is mounted as /downloads. Keep completed and incomplete data beneath /downloads/sabnzbd, using separate child directories and categories. The service listens internally on 8080; Gluetun publishes it on host port 8085 so it does not collide with qBittorrent.

Set up tv and movies categories or your chosen equivalents, and match them in Sonarr/Radarr. SABnzbd performs Usenet extraction itself. If a proxy-hostname whitelist is enabled, add only the intended sab.home.rwk.me name rather than disabling hostname protections globally.

Configure Prowlarr ​

Open Prowlarr, configure authentication, then add and test the indexers you intend to use. Keep provider accounts and API keys private. Add download clients under Settings → Download Clients using Gluetun's service name gluetun: qBittorrent port 8081 and SABnzbd port 8080.

Under Settings → Apps, connect the library managers:

FieldValue
Prowlarr Server URLhttp://gluetun:9696
Sonarr Serverhttp://sonarr:8989
Radarr Serverhttp://radarr:7878

Use each manager's API key and choose the intended synchronization level. Test both directions of connectivity, then verify a synced indexer and a search from the manager. Existing manager indexers should also use http://gluetun:9696 as their Prowlarr base URL; recheck inherited settings after changing the callback address. Prowlarr's own download-client settings do not replace the clients configured in Sonarr and Radarr.

Configure FlareSolverr ​

This helper shares Prowlarr's network namespace and VPN address. In Prowlarr's Settings → Indexer Proxies, add a FlareSolverr proxy at http://127.0.0.1:8191, assign a tag such as flaresolverr, and give the same tag to the indexers that require it. Test the proxy and each tagged indexer.

A tagless proxy is disabled by Prowlarr. Challenge handling is invoked for applicable tagged requests, not as a blanket proxy for every indexer. Keep FlareSolverr's API unpublished. The health check is available inside its container:

sh
docker exec flaresolverr curl --fail --silent http://127.0.0.1:8191/health

See the Prowlarr indexer proxy settings and FlareSolverr configuration for release-specific behavior.

Configure Unpackerr ​

Populate unpackerr/.env with the existing Sonarr/Radarr API keys from their settings, then start the helper. It reaches http://sonarr:8989 and http://radarr:7878 on servarrnetwork and shares /data with the torrent client and managers. It does not need Gluetun because it talks only to the managers and local storage.

The Compose configuration polls every two minutes, processes one archive at a time, and limits extraction to torrent protocol names. Original torrent folders are retained for seeding; extracted files are removed five minutes after successful import. SABnzbd remains responsible for Usenet extraction.

sh
cd /docker/servarr
docker compose up -d unpackerr
docker compose ps unpackerr
docker exec unpackerr curl --fail --silent --show-error --output /dev/null http://127.0.0.1:5656/

Its web interface is loopback-only and has no host port. Logs may contain generated UI credentials; treat them as private. To stop only the extraction helper, use docker compose stop unpackerr.

Configure unhealthy-container recovery ​

The shared definition labels qBittorrent, FlareSolverr, and Unpackerr with deunhealth.restart.on.unhealthy=true. deunhealth can restart those labeled unhealthy containers using the mounted Docker socket. Include it only after reviewing that administrative access and the service restart behavior. It is not a substitute for diagnosing a persistent VPN or storage failure.

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
torrent.home.rwk.mehttp://10.120.40.105:8080Enabled
sab.home.rwk.mehttp://10.120.40.105:8085Enabled
prowlarr.home.rwk.mehttp://10.120.40.105:9696Not 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.

Verify and maintain ​

Test indexer searches, client authentication, a representative download, extraction where required, and the final import. Check the VPN egress, client queues, paths, free space, and application logs in that order when diagnosing failures. Keep provider and torrent details private.

Replacing Gluetun replaces the namespace used by four consumers. Recreate those consumers as part of the same reviewed maintenance plan; restarting one VPN container without coordinating its consumers can leave stale networking. The lab's automatic deployment refuses plans that would silently restart unchanged consumers. Use the private deployment runbook and a matching backup before coordinated updates.

Source definitions and templates remain in servers/media-server/servarr in the homelab repository. Do not delete configuration or volumes to resolve a failed startup.