187 lines
9.5 KiB
Markdown
187 lines
9.5 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: "Sonarr, Radarr and Prowlarr now have alerting enabled; destination and enabled events not supplied, 2026-10-26"
|
|
- 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, home-server.operations]
|
|
update_triggers: [deployment, airvpn-device-change, route-change, storage-change, seedbox-retirement, alerting-change]
|
|
unknowns:
|
|
- selected-airvpn-server-country-and-forwarded-port
|
|
- measured-throughput-and-runtime-isolation
|
|
- airvpn-renewal-behaviour
|
|
- arr-alert-destinations-and-enabled-events
|
|
---
|
|
|
|
# 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.
|
|
|
|
## 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](operations.md#observability).
|
|
|
|
## 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.
|