Files
notes/docs/home-server/downloads.md
T

9.5 KiB

schema_version, id, type, scope, sensitivity, last_reviewed, sources, related, update_triggers, unknowns
schema_version id type scope sensitivity last_reviewed sources related update_triggers unknowns
1 home-server.downloads reference
jupiter
airvpn
gluetun
qbittorrent
media-import
private-infrastructure 2026-10-26
kind reference
owner-report Sonarr, Radarr and Prowlarr now have alerting enabled; destination and enabled events not supplied, 2026-10-26
kind reference
owner-report Former Ultra.cc subscription active since 2024-05-25, always GBP 4.50/month until retirement, 2026-10-26
kind reference
owner-report AirVPN live with direct home-ISP egress; Sonarr/Radarr imports, hardlinks and seeding/removal confirmed; public UI and both login layers working; Ultra.cc and rclone mount retired; remaining isolation checks and backups outstanding, 2026-10-26
kind reference
owner-report Cost saving and simpler architecture; three-year AirVPN plan purchased for GBP 56.06, expires Thursday, 25 October 2029, 2026-10-26
kind reference
owner-report Requested AirVPN/local qBittorrent migration with direct home-ISP egress, 2026-10-26
kind repository revision base_revision paths
repository jupiter-stacks working-tree 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
stacks/downloads/docker-compose.yml
stacks/downloads/README.md
stacks/downloads/qBittorrent.conf
stacks/downloads/resolv.conf
stacks/downloads/vpn-entrypoint.sh
stacks/sonarr/docker-compose.yml
stacks/radarr/docker-compose.yml
stacks/prowlarr/docker-compose.yml
home-server.seedbox
home-server.networking
home-server.storage
home-server.deployment
home-server.backups
home-server.operations
deployment
airvpn-device-change
route-change
storage-change
seedbox-retirement
alerting-change
selected-airvpn-server-country-and-forwarded-port
measured-throughput-and-runtime-isolation
airvpn-renewal-behaviour
arr-alert-destinations-and-enabled-events

Local downloads / AirVPN

Live by owner report on 2026-10-26. Local qBittorrent behind Gluetun/AirVPN has replaced the Ultra.cc seedbox. Downloads use the home ISP directly. Sonarr and Radarr imports, hardlinks, continued seeding and intended removal behaviour are confirmed. Ultra.cc is cancelled/expired, retained files have been handled, and the old rclone-seedbox service and FUSE mount are removed.

The change saves money and simplifies the architecture: downloads and libraries now share local storage, removing the remote seedbox, SFTP/FUSE mount and cross-filesystem import dependency. This is owner confirmation, not independent runtime inspection; the remaining isolation and recovery gaps are listed below.

Subscription / savings

Item Cost / term
Provider AirVPN; three-year plan purchased
Upfront payment GBP 56.06 for three years
Expiry Thursday, 25 October 2029
Effective subscription cost Approximately GBP 1.56/month or GBP 18.69/year, amortised over 36 months
Former Ultra.cc subscription Active since 2024-05-25 until retirement; always GBP 4.50/month (GBP 54/year), with no price changes
Subscription saving Approximately GBP 2.94/month or GBP 35.31/year; GBP 105.94 over three years at the former rate

Savings exclude incremental electricity and any future renewal price. Automatic renewal behaviour has not been recorded.

The authoritative deployment and rollback runbook is jupiter-stacks/stacks/downloads/README.md. It includes the required host files, AirVPN setup, routing acceptance gates, failure exercises, application UI changes and seedbox retirement.

Current topology

qBittorrent
  -> shared Gluetun network namespace / firewall
  -> AirVPN WireGuard packets over Jupiter's home interface/router
  -> AirVPN public exit
  -> peers

Sonarr / Radarr / optional Prowlarr direct downloads
  -> dedicated downloads Docker network
  -> http://gluetun:8080

The existing Jupiter-to-Mercury host WireGuard tunnel remains separate and unchanged. Direct home-ISP egress, not Mercury, is confirmed by the owner. Recheck host routing and packet-marking rules after network or endpoint changes.

Repository configuration

Surface Configuration
Downloads stack Pinned Gluetun and LinuxServer qBittorrent images in one Compose project
Egress isolation qBittorrent uses network_mode: service:gluetun; enabled Gluetun firewall; initial torrent interface binding wg0
Startup Compose health dependency plus a per-start entrypoint guard before qBittorrent's original /init, including Docker automatic restarts
DNS / IPv6 qBittorrent resolver pinned to Gluetun localhost; namespace IPv6 disabled
Administration HTTPS qbittorrent.umbra.mom via Traefik/Authentik direct user bindings + MFA and qBittorrent login; loopback/SSH fallback retained
Client API gluetun:8080 on the named downloads bridge; application authentication retained
Peer ingress AirVPN-reserved TCP/UDP port allowed through the VPN firewall; no host/router publication
Secrets Root-restricted files under /data/gluetun/secrets, mounted only into Gluetun

Prowlarr and FlareSolverr indexer traffic is not moved behind AirVPN. Sonarr, Radarr and Prowlarr retain their ordinary networks and internet routes.

Public monitoring

Public access and both authentication layers are working by owner report. https://qbittorrent.umbra.mom uses Mercury's existing wildcard ingress, then Traefik and Authentik's per-user/MFA policy before qBittorrent's own login. This is the normal management UI, not a read-only monitoring account.

Traefik joins the existing downloads network to reach gluetun:8080; Gluetun and qBittorrent gain no independent network or non-VPN egress path. The router labels belong to Gluetun, which owns the shared namespace. The Authentik blueprint adds an application bound to jay (with other users assigned manually), a forward_single provider, and embedded-outpost membership; its callback router includes the new hostname.

For recovery or redeployment, follow the runbook's public-monitoring sequence: update the persisted qBittorrent Server domains setting, apply the host-side Authentik blueprint and redeploy Authentik, then Traefik and the Downloads pair. Merely changing the qBittorrent defaults does not update a running installation. Retain native authentication and CSRF/host protections; do not expose an unauthenticated API. DNS must resolve the public hostname to Mercury, not to an AirVPN exit.

Sonarr/Radarr/Prowlarr keep using the internal API. Only browser ingress uses Mercury; torrent internet traffic still uses AirVPN through the home ISP.

Local storage and imports

Existing host libraries stay at /data/jellyfin/movies and /data/jellyfin/tv_shows. New downloads live under /data/jellyfin/torrents/{incomplete,movies,tv}.

Sonarr/Radarr receive one /data/jellyfin:/media mount so imports can hardlink within one filesystem. The replacement library roots are /media/tv_shows and /media/movies, rather than /tv and /movies, without moving existing host files. Jellyfin's existing /data/jellyfin:/media mount stays unchanged; download folders must not be included in its library roots.

qBittorrent receives only /data/jellyfin/torrents:/media/torrents, not the organised media libraries. All three applications see reported download paths consistently. Repository/runbook categories are sonarr and radarr, with their corresponding download folders. Both applications' hardlink imports and intended seeding/removal behaviour are confirmed by the owner.

Deploy Downloads before the consumer stacks: it creates their external downloads network. Updating Compose does not change download-client settings, categories, roots or remote-path mappings stored in application databases. During recovery, restore or reconcile that state before resuming jobs. The runbook's old-queue migration steps are historical now that Ultra.cc is retired.

Alerting

Sonarr, Radarr and Prowlarr have alerting enabled, by owner report on 2026-10-26. Connections are managed in each application's Settings -> Connect; the destinations and selected events have not been recorded.

This does not establish coverage for empty indexer searches, releases rejected by quality/profile rules, or stalled torrents. A successful search with no acceptable results is not normally a health failure. Missing-media or stalled-download alerts need separate monitoring if required.

Existing host/container and Discord notification coverage is documented in Operations.

Remaining validation / recovery gaps

  • Record the non-secret server country and reserved peer port if needed for operations; never put device keys in these notes.
  • Direct home-ISP egress and normal downloads are confirmed; working inbound peer connectivity, DNS confinement and IPv6 denial are not yet fully recorded.
  • Exercise tunnel failure, unavailable VPN at startup, Gluetun replacement and host reboot; no unprotected internet fallback is acceptable.
  • Add qBittorrent state/defaults and VPN secrets to the actual encrypted backup policy; the owner confirms they are not yet covered. The documented six-directory plan does not cover them.

Seedbox retirement and the local import workflow are complete by owner report; the former seedbox is no longer an available rollback assumption.

The HDD array remains RAID 0 without redundancy. Hardlinks save space but are not independent copies or backups.