5.8 KiB
5.8 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 |
|
private-infrastructure | 2026-10-27 |
|
|
|
|
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; local imports remove the SFTP/FUSE dependency.
- Working downloads do not prove fail-closed behaviour; outstanding exercises below.
Current topology
---
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 -> Authentik -> 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:8080via 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.
- Backup coverage: Backups; alerts: Operations.
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.