---
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.