9.5 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-26 |
|
|
|
|
Local downloads / AirVPN
Live by owner report on 2026-10-26. Local qBittorrent behind Gluetun/AirVPN has replaced the Ultra.cc seedbox. Downloads use the home ISP directly. Sonarr and Radarr imports, hardlinks, continued seeding and intended removal behaviour are confirmed. Ultra.cc is cancelled/expired, retained files have been handled, and the old rclone-seedbox service and FUSE mount are removed.
The change saves money and simplifies the architecture: downloads and libraries now share local storage, removing the remote seedbox, SFTP/FUSE mount and cross-filesystem import dependency. This is owner confirmation, not independent runtime inspection; the remaining isolation and recovery gaps are listed below.
Subscription / savings
| Item | Cost / term |
|---|---|
| Provider | AirVPN; three-year plan purchased |
| Upfront payment | GBP 56.06 for three years |
| Expiry | Thursday, 25 October 2029 |
| Effective subscription cost | Approximately GBP 1.56/month or GBP 18.69/year, amortised over 36 months |
| Former Ultra.cc subscription | Active since 2024-05-25 until retirement; always GBP 4.50/month (GBP 54/year), with no price changes |
| Subscription saving | Approximately GBP 2.94/month or GBP 35.31/year; GBP 105.94 over three years at the former rate |
Savings exclude incremental electricity and any future renewal price. Automatic renewal behaviour has not been recorded.
The authoritative deployment and rollback runbook is
jupiter-stacks/stacks/downloads/README.md.
It includes the required host files, AirVPN setup, routing acceptance gates,
failure exercises, application UI changes and seedbox retirement.
Current topology
qBittorrent
-> shared Gluetun network namespace / firewall
-> AirVPN WireGuard packets over Jupiter's home interface/router
-> AirVPN public exit
-> peers
Sonarr / Radarr / optional Prowlarr direct downloads
-> dedicated downloads Docker network
-> http://gluetun:8080
The existing Jupiter-to-Mercury host WireGuard tunnel remains separate and unchanged. Direct home-ISP egress, not Mercury, is confirmed by the owner. Recheck host routing and packet-marking rules after network or endpoint changes.
Repository configuration
| Surface | Configuration |
|---|---|
| Downloads stack | Pinned Gluetun and LinuxServer qBittorrent images in one Compose project |
| Egress isolation | qBittorrent uses network_mode: service:gluetun; enabled Gluetun firewall; initial torrent interface binding wg0 |
| Startup | Compose health dependency plus a per-start entrypoint guard before qBittorrent's original /init, including Docker automatic restarts |
| DNS / IPv6 | qBittorrent resolver pinned to Gluetun localhost; namespace IPv6 disabled |
| Administration | HTTPS qbittorrent.umbra.mom via Traefik/Authentik direct user bindings + MFA and qBittorrent login; loopback/SSH fallback retained |
| Client API | gluetun:8080 on the named downloads bridge; application authentication retained |
| Peer ingress | AirVPN-reserved TCP/UDP port allowed through the VPN firewall; no host/router publication |
| Secrets | Root-restricted files under /data/gluetun/secrets, mounted only into Gluetun |
Prowlarr and FlareSolverr indexer traffic is not moved behind AirVPN. Sonarr, Radarr and Prowlarr retain their ordinary networks and internet routes.
Public monitoring
Public access and both authentication layers are working by owner report.
https://qbittorrent.umbra.mom uses Mercury's existing wildcard ingress, then
Traefik and Authentik's per-user/MFA policy before qBittorrent's own login.
This is the normal management UI, not a read-only monitoring account.
Traefik joins the existing downloads network to reach gluetun:8080;
Gluetun and qBittorrent gain no independent network or non-VPN egress path.
The router labels belong to Gluetun, which owns the shared namespace.
The Authentik blueprint adds an application bound to jay (with other users
assigned manually), a forward_single
provider, and embedded-outpost membership; its callback router includes the
new hostname.
For recovery or redeployment, follow the runbook's public-monitoring sequence: update the persisted qBittorrent Server domains setting, apply the host-side Authentik blueprint and redeploy Authentik, then Traefik and the Downloads pair. Merely changing the qBittorrent defaults does not update a running installation. Retain native authentication and CSRF/host protections; do not expose an unauthenticated API. DNS must resolve the public hostname to Mercury, not to an AirVPN exit.
Sonarr/Radarr/Prowlarr keep using the internal API. Only browser ingress uses Mercury; torrent internet traffic still uses AirVPN through the home ISP.
Local storage and imports
Existing host libraries stay at /data/jellyfin/movies and
/data/jellyfin/tv_shows. New downloads live under
/data/jellyfin/torrents/{incomplete,movies,tv}.
Sonarr/Radarr receive one /data/jellyfin:/media mount so imports can hardlink
within one filesystem. The replacement library roots are /media/tv_shows
and /media/movies, rather than /tv and /movies, without moving
existing host files. Jellyfin's existing /data/jellyfin:/media mount stays
unchanged; download folders must not be included in its library roots.
qBittorrent receives only /data/jellyfin/torrents:/media/torrents, not the
organised media libraries. All three applications see reported download paths
consistently. Repository/runbook categories are sonarr and radarr, with their
corresponding download folders. Both applications' hardlink imports and intended
seeding/removal behaviour are confirmed by the owner.
Deploy Downloads before the consumer stacks: it creates their external
downloads network. Updating Compose does not change download-client settings,
categories, roots or remote-path mappings stored in application databases.
During recovery, restore or reconcile that state before resuming jobs.
The runbook's old-queue migration steps are historical now that Ultra.cc is retired.
Alerting
Sonarr, Radarr and Prowlarr have alerting enabled, by owner report on 2026-10-26. Connections are managed in each application's Settings -> Connect; the destinations and selected events have not been recorded.
This does not establish coverage for empty indexer searches, releases rejected by quality/profile rules, or stalled torrents. A successful search with no acceptable results is not normally a health failure. Missing-media or stalled-download alerts need separate monitoring if required.
Existing host/container and Discord notification coverage is documented in Operations.
Remaining validation / recovery gaps
- Record the non-secret server country and reserved peer port if needed for operations; never put device keys in these notes.
- Direct home-ISP egress and normal downloads are confirmed; working inbound peer connectivity, DNS confinement and IPv6 denial are not yet fully recorded.
- Exercise tunnel failure, unavailable VPN at startup, Gluetun replacement and host reboot; no unprotected internet fallback is acceptable.
- Add qBittorrent state/defaults and VPN secrets to the actual encrypted backup policy; the owner confirms they are not yet covered. The documented six-directory plan does not cover them.
Seedbox retirement and the local import workflow are complete by owner report; the former seedbox is no longer an available rollback assumption.
The HDD array remains RAID 0 without redundancy. Hardlinks save space but are not independent copies or backups.