108 lines
5.8 KiB
Markdown
108 lines
5.8 KiB
Markdown
---
|
|
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<br/>torrent interface wg0"]:::infraService
|
|
VPN["Gluetun<br/>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.
|