Files
notes/docs/home-server/downloads.md
T
2026-10-26 12:10:24 +00:00

170 lines
8.7 KiB
Markdown

---
schema_version: 1
id: home-server.downloads
type: reference
scope: [jupiter, airvpn, gluetun, qbittorrent, media-import]
sensitivity: private-infrastructure
last_reviewed: "2026-10-26"
sources:
- kind: owner-report
reference: "Former Ultra.cc subscription active since 2024-05-25, always GBP 4.50/month until retirement, 2026-10-26"
- kind: owner-report
reference: "AirVPN live with direct home-ISP egress; Sonarr/Radarr imports, hardlinks and seeding/removal confirmed; public UI and both login layers working; Ultra.cc and rclone mount retired; remaining isolation checks and backups outstanding, 2026-10-26"
- kind: owner-report
reference: "Cost saving and simpler architecture; three-year AirVPN plan purchased for GBP 56.06, expires Thursday, 25 October 2029, 2026-10-26"
- kind: owner-report
reference: "Requested AirVPN/local qBittorrent migration with direct home-ISP egress, 2026-10-26"
- kind: repository
repository: jupiter-stacks
revision: working-tree
base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
paths:
- stacks/downloads/docker-compose.yml
- stacks/downloads/README.md
- stacks/downloads/qBittorrent.conf
- stacks/downloads/resolv.conf
- stacks/downloads/vpn-entrypoint.sh
- stacks/sonarr/docker-compose.yml
- stacks/radarr/docker-compose.yml
- stacks/prowlarr/docker-compose.yml
related: [home-server.seedbox, home-server.networking, home-server.storage, home-server.deployment, home-server.backups]
update_triggers: [deployment, airvpn-device-change, route-change, storage-change, seedbox-retirement]
unknowns:
- selected-airvpn-server-country-and-forwarded-port
- measured-throughput-and-runtime-isolation
- airvpn-renewal-behaviour
---
# Local downloads / AirVPN
**Live by owner report on 2026-10-26.** Local qBittorrent behind Gluetun/AirVPN
has replaced the [Ultra.cc seedbox](seedbox.md). 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](https://airvpn.org/); 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`](https://github.com/jayo60013/jupiter-stacks/blob/main/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
```text
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.
## 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.