Files
2026-10-27 12:21:10 +00:00

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
jupiter
airvpn
gluetun
qbittorrent
private-infrastructure 2026-10-27
kind reference
owner-report 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 revision base_revision paths
repository jupiter-stacks working-tree 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
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
home-server.networking
home-server.storage
home-server.deployment
home-server.backups
home-server.operations
home-server.seedbox
airvpn-device-change
route-change
storage-change
renewal
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; 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: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.
  • 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.