--- schema_version: 1 id: home-server.downloads type: reference scope: [jupiter, airvpn, gluetun, qbittorrent, media-import] sensitivity: private-infrastructure last_reviewed: "2026-10-26" sources: - kind: owner-report reference: "Former Ultra.cc subscription active since 2024-05-25, always GBP 4.50/month until retirement, 2026-10-26" - kind: owner-report reference: "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: owner-report reference: "Cost saving and simpler architecture; three-year AirVPN plan purchased for GBP 56.06, expires Thursday, 25 October 2029, 2026-10-26" - kind: owner-report reference: "Requested AirVPN/local qBittorrent migration with direct home-ISP egress, 2026-10-26" - kind: repository repository: jupiter-stacks revision: working-tree base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a paths: - 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 related: [home-server.seedbox, home-server.networking, home-server.storage, home-server.deployment, home-server.backups] update_triggers: [deployment, airvpn-device-change, route-change, storage-change, seedbox-retirement] unknowns: - selected-airvpn-server-country-and-forwarded-port - measured-throughput-and-runtime-isolation - airvpn-renewal-behaviour --- # Local downloads / AirVPN **Live by owner report on 2026-10-26.** Local qBittorrent behind Gluetun/AirVPN has replaced the [Ultra.cc seedbox](seedbox.md). 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](https://airvpn.org/); 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`](https://github.com/jayo60013/jupiter-stacks/blob/main/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 ```text 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. ## 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.