--- schema_version: 1 id: home-server.downloads type: reference scope: [jupiter, airvpn, gluetun, qbittorrent] sensitivity: private-infrastructure last_reviewed: "2026-10-27" sources: - kind: owner-report reference: "AirVPN egress, imports/hardlinks, seeding/removal and authenticated UI live; subscription details and Ultra.cc retirement confirmed 2026-10-26; isolation exercises incomplete" - kind: repository repository: jupiter-stacks revision: working-tree base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a paths: [stacks/downloads/docker-compose.yml, stacks/downloads/qBittorrent.conf, stacks/downloads/resolv.conf, stacks/downloads/vpn-entrypoint.sh, stacks/sonarr/docker-compose.yml, stacks/radarr/docker-compose.yml] related: [home-server.networking, home-server.storage, home-server.deployment, home-server.backups, home-server.operations, home-server.seedbox] update_triggers: [airvpn-device-change, route-change, storage-change, renewal] unknowns: [airvpn-country-and-reserved-port, measured-throughput, complete-runtime-isolation, renewal-behaviour] --- # Local downloads / AirVPN - **Live, owner-confirmed 2026-10-26:** home-ISP egress, Sonarr/Radarr hardlink imports, seeding/removal and both Web UI login layers. - Replaces [Ultra.cc](seedbox.md); local imports remove the SFTP/FUSE dependency. - Working downloads do **not** prove fail-closed behaviour; outstanding exercises below. ## Current topology ```mermaid --- config: themeCSS: | text,.nodeLabel,.cluster-label { fill:var(--infra-text);color:var(--infra-text); } .edgeLabel,.edgeLabel p { background:var(--infra-zone);color:var(--infra-text); } .flowchart-link { stroke:var(--infra-line); } marker path { fill:var(--infra-line);stroke:var(--infra-line); } .cluster rect { fill:var(--infra-zone);stroke:var(--infra-border);stroke-dasharray:5 5;rx:12px;ry:12px; } .cluster span,.cluster text { color:var(--infra-text)!important;fill:var(--infra-text)!important; } .infraClient rect { fill:var(--infra-client-fill);stroke:var(--infra-client-stroke);rx:8px;ry:8px; } .infraService rect { fill:var(--infra-service-fill);stroke:var(--infra-service-stroke);rx:8px;ry:8px; } .infraEdge rect { fill:var(--infra-edge-fill);stroke:var(--infra-edge-stroke);rx:8px;ry:8px; } .infraCloud rect { fill:var(--infra-cloud-fill);stroke:var(--infra-cloud-stroke);rx:8px;ry:8px; } --- flowchart LR accTitle: Download API and VPN-only torrent egress accDescr: Arr uses the internal authenticated API. qBittorrent shares Gluetun's namespace and reaches peers through AirVPN, not Mercury. Arr["Sonarr / Radarr / Prowlarr"]:::infraClient subgraph Namespace["SHARED NETWORK NAMESPACE"] Qbit["qBittorrent
torrent interface wg0"]:::infraService VPN["Gluetun
firewall + WireGuard"]:::infraEdge end ISP["Home ISP"]:::infraEdge Exit["AirVPN exit"]:::infraCloud Peers["Torrent peers"]:::infraClient Arr -->|"HTTP gluetun:8080 / native login"| Qbit Qbit --> VPN -->|"Encrypted VPN"| ISP --> Exit <--> Peers ``` | Surface | Configuration | | --- | --- | | Namespace | `network_mode: service:gluetun`; enabled firewall; initial torrent binding `wg0` | | Startup | Compose health dependency + per-start guard before `/init`, including Docker restarts | | DNS / IPv6 | qBittorrent resolver pinned to Gluetun localhost; namespace IPv6 disabled | | Network | Named `downloads` bridge, non-internal, IPv6 disabled; Gluetun, Traefik and Arr attach | | Peer ingress | AirVPN-reserved TCP/UDP port; allowed by VPN firewall, **not** published on host/router | | Indexers | Prowlarr/FlareSolverr and Arr ordinary internet traffic stay outside AirVPN | ## Public monitoring - Browser: `https://qbittorrent.umbra.mom`; [Mercury ingress](networking.md#application-ingress) -> [Authentik](authentication.md#forward-auth) -> native qBittorrent login. - Full management UI, **not read-only**. Arr uses the internal API, not the public URL. - Traefik reaches `gluetun:8080`; router labels belong to Gluetun. qBittorrent gets no extra network/egress path. - Loopback fallback: `127.0.0.1:8080` via SSH forwarding. - Persist qBittorrent's **Server domains** before public routing; defaults do not update existing state. Apply the host Authentik blueprint/callback membership. - Retain native authentication, CSRF and host checks; public DNS points to Mercury, never the VPN exit. ## State and redeployment | Host path | State | | --- | --- | | `/data/qbittorrent/config` | Settings, torrent/resume state | | `/data/qbittorrent/defaults` | Initial config, startup guard and resolver files | | `/data/gluetun/secrets` | Root-restricted WireGuard private/preshared keys; Gluetun-only mounts | - Prepare bind files/keys before deployment; address, country and reserved port are stack variables. - Deploy Downloads before its network consumers; replace Gluetun/qBittorrent **together**. - Arr DB/UI state: native API credentials, categories `sonarr`/`radarr`, roots and remote-path mappings. Restore/reconcile before jobs resume. - Payload/library paths and mount boundaries: [Storage](storage.md#media-mounts). - Backup coverage: [Backups](backups.md#local-downloads-recovery-gap); alerts: [Operations](operations.md#observability). ## Subscription / savings | Item | Value | | --- | --- | | AirVPN | GBP **56.06 / three years**, expires **2029-10-25** | | Amortised cost | GBP 1.56/month / 18.69/year | | Former Ultra.cc | GBP 4.50/month since 2024-05-25; no price changes | | Saving | GBP 2.94/month / 35.31/year / 105.94 over three years | - Excludes incremental electricity and renewal changes; auto-renewal unknown. ## Remaining validation - Record non-secret server country, tunnel address and reserved port. - Prove inbound peer connectivity, DNS confinement and IPv6 denial. - Exercise VPN failure, unavailable VPN at startup, Gluetun replacement and host reboot; **no unprotected fallback**. - The retired seedbox is not a rollback target.