update notes for airvpn

This commit is contained in:
John Gatward committed 2026-10-26 12:10:24 +00:00
1 parent f8cc6f6419
commit 699f81436b
13 files changed
+504 -154

No files matched your search

+49 -24
View File
@@ -2,10 +2,14 @@
schema_version: 1 schema_version: 1
id: home-server.authentication id: home-server.authentication
type: reference type: reference
scope: [jupiter, authentik, oidc, forward-auth, access-groups, secrets] scope: [jupiter, authentik, oidc, forward-auth, per-user-access, secrets]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-18" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "Public qbittorrent.umbra.mom UI working through Mercury/Traefik/Authentik with native qBittorrent login retained, 2026-10-26; does not establish broader per-user migration completion"
- kind: owner-report
reference: "Requested removal of custom service-access groups, manual per-user application access and retained Jay administration, 2026-10-26; repository prepared, deployment unconfirmed"
- kind: owner-report - kind: owner-report
reference: "Requested Authentik-only Homarr login and read-only Docker socket proxy; deployment not confirmed, 2026-10-18" reference: "Requested Authentik-only Homarr login and read-only Docker socket proxy; deployment not confirmed, 2026-10-18"
- kind: owner-report - kind: owner-report
@@ -49,16 +53,18 @@ sources:
related: [home-server.reference, home-server.networking, home-server.portainer, home-server.backups, home-server.deployment] related: [home-server.reference, home-server.networking, home-server.portainer, home-server.backups, home-server.deployment]
update_triggers: [access-policy-change, authentication-change, secret-rotation, middleware-change] update_triggers: [access-policy-change, authentication-change, secret-rotation, middleware-change]
unknowns: unknowns:
- deployed-group-memberships - deployed-per-user-bindings-and-jay-superuser-membership
- per-application-local-login-and-account-linking-settings - per-application-local-login-and-account-linking-settings
- retired-authelia-data-retention - retired-authelia-data-retention
--- ---
# Authentication # Authentication
Authentik replaces Authelia. The owner wanted native OIDC rather than only Authentik replaces Authelia. The original setup used native OIDC and forward-auth
forward-auth, with three access groups separating server administration, with three access groups. On 2026-10-26 the owner requested direct per-user
development tools and client-facing services. The owner reports the migration service access instead; the repository now prepares that migration, with `jay`
allowed into every configured application. Deployment is unconfirmed.
The owner reports the earlier Authentik migration
fully deployed as of 2026-10-16 and Authelia retired. Homarr OIDC login was fully deployed as of 2026-10-16 and Authelia retired. Homarr OIDC login was
reported working on 2026-10-18; linking to the existing account is configured reported working on 2026-10-18; linking to the existing account is configured
in the repository but has not been confirmed successful. in the repository but has not been confirmed successful.
@@ -74,23 +80,34 @@ Configuration details below are repository evidence, not live inspection.
| Recent MFA | Five-minute reuse threshold avoids an immediate duplicate challenge | | Recent MFA | Five-minute reuse threshold avoids an immediate duplicate challenge |
| Host setup access | Loopback `127.0.0.1:9000` -> server `9000` | | Host setup access | Loopback `127.0.0.1:9000` -> server `9000` |
## Access groups ## Per-user application access
Owner terminology maps to the blueprint's exact group names: Every one of the 15 configured applications has a direct binding for the
**existing** Authentik user `jay`, at order `0`. Applications use
`policy_engine_mode: any`: Jay **or** another explicitly added user may pass.
Unassigned users are denied, and the shared application-MFA flow remains.
The blueprint does not create users or change passwords, MFA devices or
application-native administrator roles.
| Intended group | Authentik group | Purpose / applications | Add other users in the application's **Policy / Group / User Bindings** tab,
| --- | --- | --- | using a **User** binding with order `10` or higher, enabled and not negated.
| Admin | `admins` | Owner only; server health/operations: Backrest, Beszel, Dozzle, Notes, Prowlarr, Radarr, Sonarr | Keep ANY mode and retain Jay's order-0 binding. Manual bindings at other orders
| Developers | `development` | Development services: Gitea, Portainer | are not removed by blueprint reapplication. Admission does not itself grant
| Clients | `clients` | Useful end-user services: Immich, Paperless, Wardrowbe | administrator privileges inside a service.
Each application in the access-group table has an enabled group binding; `policy_engine_mode: all`; The blueprint deletes only the custom `admins`, `development` and `clients`
binding failure result is false. All three groups have `is_superuser: false`: groups after replacing their bindings; their memberships and group-based grants
`admins` application access is not Authentik superuser status. are removed. **Retain Jay's built-in superuser group membership**, normally
No group hierarchy or membership assignment is declared by this blueprint. `authentik Admins`: Authentik derives administrator status from a superuser
Membership in `admins` alone does not grant the development/client applications; group, so removing every group would lock out administration.
users needing multiple categories need the corresponding memberships.
Actual deployed membership assignments were not supplied. Before applying, back up Authentik, confirm Jay is still a superuser, and redeploy
Trek with its username-based admin mapping. Copy the updated blueprint into the
host's `/data/authentik/blueprints/jupiter.yaml` and apply it, then individually
assign the other users you want to retain. See the
[access-management runbook](https://github.com/jayo60013/jupiter-stacks/blob/main/stacks/authentik/README.md)
for rollout and rollback. Existing application sessions/API keys need separate
revocation when removing access.
## Native OIDC ## Native OIDC
@@ -107,11 +124,12 @@ Issuer pattern: `https://auth.umbra.mom/application/o/<client-id>/`.
| `immich` | `photos.umbra.mom` | Database/UI OAuth settings; web and mobile callbacks registered | | `immich` | `photos.umbra.mom` | Database/UI OAuth settings; web and mobile callbacks registered |
| `paperless` | `paperless.umbra.mom` | Compose OpenID Connect/allauth configuration; PKCE enabled; signups disabled | | `paperless` | `paperless.umbra.mom` | Compose OpenID Connect/allauth configuration; PKCE enabled; signups disabled |
| `portainer` | `portainer.umbra.mom`, `portainer.local.umbra.mom` | Database/UI OAuth settings; both callback hosts registered | | `portainer` | `portainer.umbra.mom`, `portainer.local.umbra.mom` | Database/UI OAuth settings; both callback hosts registered |
| `trek` | `holidays.umbra.mom` | Compose OIDC settings; `preferred_username == jay` grants the app admin role |
| `wardrowbe` | `wardrobe.umbra.mom` | Compose OIDC settings for frontend and backend/workers | | `wardrowbe` | `wardrobe.umbra.mom` | Compose OIDC settings for frontend and backend/workers |
Dozzle's custom profile mapping emits `dozzle_roles: ["none"]` for `admins` Dozzle's custom profile mapping emits `dozzle_roles: ["none"]` for any user
members and `[]` otherwise; application access is separately restricted to admitted by its direct application bindings. Its Docker proxy stays read-only.
`admins`. The email mapping asserts `email_verified` only when the user has The email mapping asserts `email_verified` only when the user has
an email and their `email_verified` attribute is explicitly true. an email and their `email_verified` attribute is explicitly true.
OIDC integration does not prove local password login is disabled or application OIDC integration does not prove local password login is disabled or application
@@ -180,7 +198,14 @@ proxy-based protection. Their routers attach `authentik@docker`:
Traefik -> http://authentik-server:9000/outpost.goauthentik.io/auth/traefik Traefik -> http://authentik-server:9000/outpost.goauthentik.io/auth/traefik
``` ```
The embedded outpost serves five `forward_single` providers, each with an The blueprint now includes a sixth `forward_single` provider for
`qbittorrent.umbra.mom`, with a direct `jay` user binding and the shared MFA flow.
The owner confirms its public UI and both authentication layers are working
on 2026-10-26. This confirmation is specific to qBittorrent, not proof that the
broader per-user access migration is complete. qBittorrent retains its own password login, and internal Arr API
connections do not pass through Authentik. See [Local downloads](downloads.md).
The embedded-outpost blueprint lists six `forward_single` providers, each with an
explicit external host and empty `skip_path_regex`. A priority-1000 router explicit external host and empty `skip_path_regex`. A priority-1000 router
on those hosts sends `/outpost.goauthentik.io/` directly to Authentik, on those hosts sends `/outpost.goauthentik.io/` directly to Authentik,
bypassing forward-auth so callbacks can complete. bypassing forward-auth so callbacks can complete.
+19 -2
View File
@@ -4,8 +4,10 @@ id: home-server.backups
type: reference type: reference
scope: [jupiter, backrest, restic, google-drive, recovery] scope: [jupiter, backrest, restic, google-drive, recovery]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-23" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "Live AirVPN downloads; qBittorrent state/defaults and AirVPN WireGuard secrets not yet added to encrypted off-host backups, 2026-10-26"
- kind: owner-report - kind: owner-report
reference: "Backrest plan JSON, destination, key custody and no restore test, 2026-10-06" reference: "Backrest plan JSON, destination, key custody and no restore test, 2026-10-06"
- kind: owner-report - kind: owner-report
@@ -26,7 +28,7 @@ sources:
- stacks/vaultwarden/docker-compose.yml - stacks/vaultwarden/docker-compose.yml
- stacks/authentik/docker-compose.yml - stacks/authentik/docker-compose.yml
- stacks/wardrowbe/docker-compose.yml - stacks/wardrowbe/docker-compose.yml
related: [home-server.reference, home-server.storage, home-server.portainer, home-server.authentication, home-server.operations] related: [home-server.reference, home-server.downloads, home-server.storage, home-server.portainer, home-server.authentication, home-server.operations]
update_triggers: [backup-plan-change, destination-change, hook-change, credential-change, restore-test] update_triggers: [backup-plan-change, destination-change, hook-change, credential-change, restore-test]
unknowns: unknowns:
- last-successful-backup-and-repository-check - last-successful-backup-and-repository-check
@@ -74,6 +76,21 @@ Case-insensitive exclusions: `/userdata/gitea/gitea/packages`,
`excludes: []`; CLI `--skip-if-unchanged` supplied despite `excludes: []`; CLI `--skip-if-unchanged` supplied despite
plan `skipIfUnchanged: false`. Unchanged runs may create no snapshot. plan `skipIfUnchanged: false`. Unchanged runs may create no snapshot.
### Local-downloads recovery gap
The owner confirms on 2026-10-26 that the live [AirVPN download stack](downloads.md)
has **not** yet been added to encrypted off-host backups. Missing recovery state:
`/data/qbittorrent/config` (settings/torrent state),
`/data/qbittorrent/defaults` (defaults and startup/resolver files), and
`/data/gluetun/secrets` (WireGuard private/preshared keys). The reserved peer
port, tunnel address and server-country settings also need recoverable
deployment configuration; no secret values belong in these notes.
Torrent payloads and media libraries remain outside the six-directory plan.
Hardlinks are not backups. Ultra.cc is retired and is no longer a remote
source to assume during recovery. Removing `rclone-seedbox.service` does not
remove Backrest's separate Google Drive/rclone dependency.
## Consistency hooks ## Consistency hooks
Stop timeout `120s`; chains use `&&`. Errors: `ON_ERROR_FATAL`, Stop timeout `120s`; chains use `&&`. Errors: `ON_ERROR_FATAL`,
+38 -3
View File
@@ -4,8 +4,21 @@ id: home-server.deployment
type: reference type: reference
scope: [jupiter, portainer, github, stack-deployment, secrets] scope: [jupiter, portainer, github, stack-deployment, secrets]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-18" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "AirVPN local downloads and public authenticated qBittorrent UI live; Ultra.cc/rclone retired; encrypted download-state/secret backups not yet added, 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/sonarr/docker-compose.yml
- stacks/radarr/docker-compose.yml
- stacks/prowlarr/docker-compose.yml
- stacks/traefik/docker-compose.yml
- kind: repository - kind: repository
repository: jupiter-stacks repository: jupiter-stacks
revision: 026cfa58b601165342b278401183c5fed5a50db2 revision: 026cfa58b601165342b278401183c5fed5a50db2
@@ -31,7 +44,7 @@ sources:
- stacks/gitea/docker-compose.yml - stacks/gitea/docker-compose.yml
- stacks/immich/docker-compose.yml - stacks/immich/docker-compose.yml
- stacks/paperless-ngx/docker-compose.yml - stacks/paperless-ngx/docker-compose.yml
related: [home-server.reference, home-server.host, home-server.portainer, home-server.authentication, home-server.backups, home-server.operations, home-server.notes] related: [home-server.reference, home-server.host, home-server.portainer, home-server.authentication, home-server.backups, home-server.operations, home-server.notes, home-server.downloads]
update_triggers: [deployment-workflow-change, repository-change, credential-rotation, rollback-policy-change] update_triggers: [deployment-workflow-change, repository-change, credential-rotation, rollback-policy-change]
unknowns: unknowns:
- github-pat-scopes-and-expiration - github-pat-scopes-and-expiration
@@ -45,7 +58,7 @@ unknowns:
| Stack definitions | <https://github.com/jayo60013/jupiter-stacks> | | Stack definitions | <https://github.com/jayo60013/jupiter-stacks> |
| Git ref | `main` | | Git ref | `main` |
| Repository authentication | GitHub PAT configured in Portainer | | Repository authentication | GitHub PAT configured in Portainer |
| Environment values/secrets | Portainer stack environment settings | | Environment values/secrets | Portainer stack environment settings; AirVPN keys use root-restricted host secret files |
| Deployment | Manually pull/redeploy each affected stack in Portainer | | Deployment | Manually pull/redeploy each affected stack in Portainer |
| Portainer itself | [Host shell script](portainer.md), not a managed Compose stack | | Portainer itself | [Host shell script](portainer.md), not a managed Compose stack |
@@ -65,6 +78,28 @@ No independent recovery arrangement exists for the PAT or stack secrets.
Rollback, health-check gates, approval rules and UI-versus-Git drift policy Rollback, health-check gates, approval rules and UI-versus-Git drift policy
are not established; do not assume permission to deploy, stop or delete services. are not established; do not assume permission to deploy, stop or delete services.
## Local downloads deployment / recovery
The owner confirms [qBittorrent/Gluetun through AirVPN](downloads.md) live on
2026-10-26, including both Arr import workflows and the authenticated public UI.
Use the linked stack runbook for reconstruction, not the retired seedbox.
Deploy Downloads before its consumers: it creates the external `downloads`
network used by Sonarr, Radarr, Prowlarr and Traefik. Prepare the bind-mounted
files under `/data/qbittorrent/{config,defaults}` and
`/data/gluetun/secrets` first. AirVPN private/preshared keys are root-restricted
host files mounted as Compose secrets, not Portainer environment values;
the tunnel address, country and reserved peer port are stack environment values.
Arr client credentials, categories, library roots, remote-path mappings and
hardlink settings are database/UI state, not reproduced by pulling Compose.
The public UI also depends on the persisted qBittorrent Server domains setting,
the host-side Authentik blueprint and Traefik's `downloads` network attachment.
Recreate Gluetun and qBittorrent together when replacing their shared namespace.
Full isolation exercises remain outstanding, and the new client state/defaults
and VPN secrets are not yet backed up. See [Backups](backups.md#local-downloads-recovery-gap).
## Notes deployment ## Notes deployment
The [Notes reference](notes.md) covers `notes_builder`, `notes_web`, host bind The [Notes reference](notes.md) covers `notes_builder`, `notes_web`, host bind
+169
View File
@@ -0,0 +1,169 @@
---
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.
+12 -5
View File
@@ -4,8 +4,10 @@ id: home-server.host
type: reference type: reference
scope: [jupiter, hardware, operating-system, docker] scope: [jupiter, hardware, operating-system, docker]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-20" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "AirVPN local downloads live; Ultra.cc retired and rclone-seedbox service/FUSE mount removed, 2026-10-26"
- kind: owner-report - kind: owner-report
reference: "Hardware, OS, bare-metal Docker and data-root confirmation, 2026-10-06" reference: "Hardware, OS, bare-metal Docker and data-root confirmation, 2026-10-06"
- kind: owner-report - kind: owner-report
@@ -60,8 +62,9 @@ unknowns:
Docker/containerd services and `docker.socket` are enabled. Docker/containerd services and `docker.socket` are enabled.
Docker starts `/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock`. Docker starts `/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock`.
Supplied Docker unit has no explicit `/data` mount dependency or ordering against Supplied Docker unit has no explicit `/data` mount dependency.
`rclone-seedbox.service`. The former `rclone-seedbox.service` and FUSE mount are removed by owner report
on 2026-10-26; Docker workloads no longer depend on that remote import mount.
### Docker log rotation ### Docker log rotation
@@ -101,8 +104,12 @@ docker inspect --format '{{json .HostConfig.LogConfig}}' CONTAINER
| `backup-puller` | UID/GID `1001:1001`; `/home/backup-puller`; bash; member of `backups`; origin/purpose not recognized by owner | | `backup-puller` | UID/GID `1001:1001`; `/home/backup-puller`; bash; member of `backups`; origin/purpose not recognized by owner |
| `backups` | Shared group; GID `1002` | | `backups` | Shared group; GID `1002` |
WireGuard and rclone: apt-managed. `wg-quick@wg0.service` is active in the supplied WireGuard and rclone were apt-managed in the supplied snapshot;
snapshot. No host-level nginx on Jupiter; nginx still exists in application removing the seedbox service does not establish that the rclone package was
uninstalled. Backrest's separate rclone configuration is not the retired mount.
`wg-quick@wg0.service` is active in the supplied snapshot and remains separate
from the containerised Gluetun/AirVPN tunnel for [local downloads](downloads.md).
No host-level nginx on Jupiter; nginx still exists in application
containers. `unattended-upgrades.service` is enabled; effective update policy containers. `unattended-upgrades.service` is enabled; effective update policy
not supplied. not supplied.
+34 -34
View File
@@ -4,8 +4,10 @@ id: home-server.ideas-next-steps
type: plan type: plan
scope: [jupiter, mercury, private-access, recovery, downloads, power, services] scope: [jupiter, mercury, private-access, recovery, downloads, power, services]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-22" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "AirVPN downloads live; GBP 56.06 three-year plan ending 2029-10-25; Ultra.cc/rclone retired; imports/hardlinks/seeding/removal and public UI confirmed; full isolation checks and backups outstanding, 2026-10-26"
- kind: owner-report - kind: owner-report
reference: "Access, device-loss recovery, hardware constraints, broadband and VPN preferences interview, 2026-10-22" reference: "Access, device-loss recovery, hardware constraints, broadband and VPN preferences interview, 2026-10-22"
- kind: documentation - kind: documentation
@@ -17,6 +19,7 @@ related:
- home-server.backups - home-server.backups
- home-server.operations - home-server.operations
- home-server.seedbox - home-server.seedbox
- home-server.downloads
- home-server.storage - home-server.storage
- home-server.host - home-server.host
update_triggers: [implementation, priority-change, access-requirements-change, pricing-change, power-measurement] update_triggers: [implementation, priority-change, access-requirements-change, pricing-change, power-measurement]
@@ -24,16 +27,16 @@ unknowns:
- live-routing-firewall-and-wireguard-configuration - live-routing-firewall-and-wireguard-configuration
- work-laptop-local-dns-and-lan-access-policy - work-laptop-local-dns-and-lan-access-policy
- measured-wall-power-and-electricity-tariff - measured-wall-power-and-electricity-tariff
- current-vpn-plan-features-and-pricing - airvpn-renewal-terms-and-complete-isolation-results
- immich-original-photo-backup-coverage - immich-original-photo-backup-coverage
--- ---
# Ideas / next steps # Ideas / next steps
Planning backlog from the 2026-10-22 discussion. These are recommendations and Planning backlog from the 2026-10-22 discussion, updated with the owner's
owner preferences, **not implemented changes or deployment evidence**. 2026-10-26 AirVPN cutover confirmation. Unchecked proposals remain
Existing reference pages describe the documented configuration; update them **recommendations, not implemented changes**; the completed downloads work
when changes are actually deployed. below is owner-reported deployed state.
## Requirements confirmed with the owner ## Requirements confirmed with the owner
@@ -48,14 +51,14 @@ when changes are actually deployed.
| Private-access tooling | Prefer minimal infrastructure and no vendor-hosted coordination service; existing Cloudflare DNS/SSH use is acceptable | | Private-access tooling | Prefer minimal infrastructure and no vendor-hosted coordination service; existing Cloudflare DNS/SSH use is acceptable |
| Hardware | Software/BIOS tuning only; no hardware purchases or removals | | Hardware | Software/BIOS tuning only; no hardware purchases or removals |
| Broadband | Reported 500 Mbps download and upload; public trackers only | | Broadband | Reported 500 Mbps download and upload; public trackers only |
| VPN candidates | Proton VPN or AirVPN; owner quotes GBP 2.50/month without upfront commitment; exact plan/features/pricing not independently checked | | Download VPN | AirVPN selected and live; three-year plan purchased for GBP 56.06, expires Thursday, 25 October 2029 |
| New services | Interested in reliability, everyday tools, media, development and privacy | | New services | Interested in reliability, everyday tools, media, development and privacy |
## Priority order ## Priority order
1. Prepare independent recovery access, then introduce private admin ingress. 1. Prepare independent recovery access, then introduce private admin ingress.
2. Make backups recoverable and add failure notifications. 2. Make backups recoverable and add failure notifications.
3. Replace the seedbox with VPN-isolated local downloads if the trial succeeds. 3. Finish download-VPN isolation checks and recovery coverage; seedbox replacement is complete.
4. Measure and tune power use. 4. Measure and tune power use.
5. Add services that solve an actual day-to-day problem. 5. Add services that solve an actual day-to-day problem.
@@ -149,35 +152,32 @@ remains necessary. See [Backups](backups.md) and [Operations](operations.md).
## Local downloads instead of the seedbox ## Local downloads instead of the seedbox
At the owner's quoted prices, replacing the GBP 4.50/month seedbox with a **Completed by owner report on 2026-10-26:**
GBP 2.50/month VPN saves **GBP 2/month or GBP 24/year before extra electricity**. [local qBittorrent/Gluetun downloads through AirVPN](downloads.md) are live.
Confirm actual plan terms before purchasing. The simpler local storage/import This is both a **cost saving** and an **architecture simplification**: local
path may be more valuable than the modest subscription saving. storage and hardlink imports replace the remote seedbox and SFTP/FUSE dependency.
### Proposed arrangement The purchased **three-year AirVPN plan cost GBP 56.06** and expires
**Thursday, 25 October 2029**. Amortised over 36 months, that is approximately
GBP 1.56/month versus Ultra.cc's former GBP 4.50/month: a subscription saving of
**GBP 35.31/year**, or **GBP 105.94 over three years**, before extra electricity.
The former GBP 2.50/month VPN estimate is superseded by this actual purchase.
- [ ] Check the chosen Proton VPN/AirVPN plan supports P2P and the intended ### Completed work and remaining follow-up
manual/container connection; assess port forwarding for peer connectivity.
- [ ] Run qBittorrent behind a VPN gateway container such as Gluetun. - [x] Deploy local qBittorrent behind Gluetun/AirVPN.
- [ ] Block torrent egress whenever the VPN is unavailable, including startup; - [x] Confirm encrypted VPN egress uses the home ISP directly, not Mercury.
use qBittorrent interface binding as additional protection. - [x] Confirm Sonarr and Radarr imports, hardlinks and intended seeding/removal.
- [ ] Keep the qBittorrent Web UI private and ensure DNS/IPv6 cannot bypass - [x] Confirm public Web UI through Mercury/Traefik/Authentik plus native
the intended VPN path. qBittorrent login; this is an intentional change from the private-only proposal.
- [ ] Keep the host, public applications and admin-access WireGuard routes on - [x] Retire Ultra.cc, handle retained files and remove the rclone-seedbox
their normal connections. The commercial download VPN is a separate job. service and FUSE mount.
- [ ] Use a common container mount layout for downloads and media on the HDD - [ ] Complete peer-ingress, DNS/IPv6 leak and VPN-failure/startup/reboot checks.
filesystem so Radarr/Sonarr can hardlink imports while torrents seed. - [ ] Add qBittorrent state/defaults and AirVPN secrets to encrypted off-host backups.
- [ ] Confirm imports, seeding, removal behaviour and VPN-failure isolation
before cancelling the seedbox.
- [ ] Migrate any retained downloads and remove the rclone/FUSE dependency only
after the replacement workflow works.
A hardlink gives the same file data two names without storing a second full A hardlink gives the same file data two names without storing a second full
copy. The current separate download/library mounts need review; sharing physical copy. Hardlinks are confirmed for both import workflows; they are not backups.
disks alone is not enough. The separate private-admin-access proposal above remains outstanding.
The [Seedbox](seedbox.md) notes record an expiry of 2026-10-25. Confirm renewal
status rather than assuming this snapshot is still the billing state.
## Electricity and compute efficiency ## Electricity and compute efficiency
@@ -194,7 +194,7 @@ Illustrative costs at **25p/kWh**, using 365 days/year divided by 12:
| 80 W | GBP 14.60 | | 80 W | GBP 14.60 |
At that illustrative tariff, saving 10 W continuously saves about GBP 18/year. At that illustrative tariff, saving 10 W continuously saves about GBP 18/year.
An extra average draw of about 11 W would consume the GBP 2/month seedbox saving. An extra average draw of about 16 W would consume the GBP 35.31/year subscription saving.
Count the incremental download workload, not the server's existing baseline. Count the incremental download workload, not the server's existing baseline.
- [ ] Measure wall power and obtain the actual unit rate when practical. - [ ] Measure wall power and obtain the actual unit rate when practical.
+8 -4
View File
@@ -2,10 +2,12 @@
schema_version: 1 schema_version: 1
id: home-server.reference id: home-server.reference
type: reference type: reference
scope: [jupiter, mercury, seedbox, shared-infrastructure] scope: [jupiter, mercury, downloads, shared-infrastructure]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-22" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "AirVPN local downloads live, Ultra.cc/rclone retired; GBP 56.06 three-year plan ending 2029-10-25 for savings and simpler architecture, 2026-10-26"
- kind: owner-report - kind: owner-report
reference: "Added ideas/next-steps planning page from owner discussion, 2026-10-22" reference: "Added ideas/next-steps planning page from owner discussion, 2026-10-22"
- kind: owner-report - kind: owner-report
@@ -16,6 +18,7 @@ related:
- home-server.host - home-server.host
- home-server.mercury - home-server.mercury
- home-server.seedbox - home-server.seedbox
- home-server.downloads
- home-server.portainer - home-server.portainer
- home-server.deployment - home-server.deployment
- home-server.notes - home-server.notes
@@ -35,14 +38,15 @@ unknowns: []
| --- | --- | | --- | --- |
| [Host](host.md) | Jupiter hardware; OS; Docker | | [Host](host.md) | Jupiter hardware; OS; Docker |
| [Mercury VPS](mercury.md) | Hosting; ingress; WireGuard; firewall | | [Mercury VPS](mercury.md) | Hosting; ingress; WireGuard; firewall |
| [Seedbox](seedbox.md) | Ultra.cc; qBittorrent; rclone mount | | [Local downloads / AirVPN](downloads.md) | Live qBittorrent/Gluetun; local hardlink imports; three-year plan GBP 56.06, expires Thursday, 25 October 2029 |
| [Seedbox (retired)](seedbox.md) | Historical Ultra.cc setup; subscription and rclone/FUSE mount retired |
| [Portainer](portainer.md) | Script-managed container; state; backups | | [Portainer](portainer.md) | Script-managed container; state; backups |
| [Deployment](deployment.md) | GitHub; Portainer; environment values | | [Deployment](deployment.md) | GitHub; Portainer; environment values |
| [Notes](notes.md) | Webhook builder; static site; networks; deployment order | | [Notes](notes.md) | Webhook builder; static site; networks; deployment order |
| [Operations / decisions](operations.md) | Tradeoffs; monitoring; recovery gaps | | [Operations / decisions](operations.md) | Tradeoffs; monitoring; recovery gaps |
| [Networking](networking.md) | Mercury; WireGuard; DNS; ingress | | [Networking](networking.md) | Mercury; WireGuard; DNS; ingress |
| [Storage](storage.md) | SSD; RAID 0; mounts; volumes | | [Storage](storage.md) | SSD; RAID 0; mounts; volumes |
| [Authentication](authentication.md) | Authentik; OIDC; access groups; forward-auth; secrets | | [Authentication](authentication.md) | Authentik; OIDC; per-user service access; forward-auth; secrets |
| [Backups](backups.md) | Backrest; coverage; retention; recovery | | [Backups](backups.md) | Backrest; coverage; retention; recovery |
| [Ideas / next steps](ideas-next-steps.md) | Proposed private access, recovery, savings and optional services; not deployed state | | [Ideas / next steps](ideas-next-steps.md) | Proposed private access, recovery, savings and optional services; not deployed state |
+70 -37
View File
@@ -2,10 +2,19 @@
schema_version: 1 schema_version: 1
id: home-server.networking id: home-server.networking
type: reference type: reference
scope: [jupiter, mercury, seedbox, dns, ingress, wireguard, cloudflare, sftp] scope: [jupiter, mercury, airvpn, downloads, dns, ingress, wireguard, cloudflare]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-16" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "AirVPN local downloads and direct home-ISP egress live; public qBittorrent UI and both authentication layers working; Ultra.cc/rclone mount retired; full failure/leak checks outstanding, 2026-10-26"
- kind: repository
repository: jupiter-stacks
revision: working-tree
base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
paths:
- stacks/downloads/docker-compose.yml
- stacks/traefik/docker-compose.yml
- kind: owner-report - kind: owner-report
reference: "Network topology, Mercury nginx/iptables/fail2ban output, LAN DNS, 2026-10-06" reference: "Network topology, Mercury nginx/iptables/fail2ban output, LAN DNS, 2026-10-06"
- kind: owner-report - kind: owner-report
@@ -31,7 +40,7 @@ sources:
paths: paths:
- stacks/authentik/docker-compose.yml - stacks/authentik/docker-compose.yml
- stacks/authentik/blueprints/jupiter.yaml - stacks/authentik/blueprints/jupiter.yaml
related: [home-server.reference, home-server.host, home-server.mercury, home-server.seedbox, home-server.authentication, home-server.operations] related: [home-server.reference, home-server.host, home-server.mercury, home-server.downloads, home-server.seedbox, home-server.authentication, home-server.operations]
update_triggers: [dns-change, proxy-change, tunnel-change, firewall-change, certificate-change, seedbox-change] update_triggers: [dns-change, proxy-change, tunnel-change, firewall-change, certificate-change, seedbox-change]
unknowns: unknowns:
- public-dns-record-types-and-cloudflare-proxy-status - public-dns-record-types-and-cloudflare-proxy-status
@@ -39,12 +48,26 @@ unknowns:
- wireguard-allowedips-and-keepalive - wireguard-allowedips-and-keepalive
- jupiter-firewall-policy - jupiter-firewall-policy
- traefik-forwarded-header-trust-configuration - traefik-forwarded-header-trust-configuration
- seedbox-sftp-port-and-download-client-api-endpoint - complete-airvpn-failure-dns-and-ipv6-isolation-results
--- ---
# Networking # Networking
## HTTPS ingress / seedbox connectivity ## AirVPN downloads
[VPN-isolated local downloads](downloads.md) are live by owner report on
2026-10-26. Gluetun connects directly to AirVPN through the home ISP, separate
from the existing Mercury tunnel. Ultra.cc and the rclone/FUSE mount are retired.
This cuts subscription costs and removes the remote-storage/import dependency.
Full failure, DNS and IPv6 isolation checks are still outstanding.
Public monitoring at `qbittorrent.umbra.mom` is working: Mercury's wildcard
HTTPS ingress reaches Traefik, which joins `downloads` and applies Authentik
per-user/MFA protection before proxying to `gluetun:8080`. The outpost callback
hostname is registered separately. This does not route torrent egress through
Mercury; see the [public-monitoring deployment steps](downloads.md#public-monitoring).
## HTTPS ingress / local downloads
```mermaid ```mermaid
--- ---
@@ -78,27 +101,32 @@ flowchart TB
Traefik["<b>Traefik</b><br/>192.168.1.56<br/>WireGuard 10.0.0.2"] Traefik["<b>Traefik</b><br/>192.168.1.56<br/>WireGuard 10.0.0.2"]
Apps["<b>Application containers</b><br/>Docker network: traefik"] Apps["<b>Application containers</b><br/>Docker network: traefik"]
Arr["<b>Radarr / Sonarr</b><br/>Download control / media imports"] Arr["<b>Radarr / Sonarr</b><br/>Download control / media imports"]
Rclone["<b>Host rclone / FUSE</b><br/>/mnt/seedbox"] Qbit["<b>qBittorrent</b><br/>Shared Gluetun namespace"]
Gluetun["<b>Gluetun</b><br/>WireGuard / firewall<br/>downloads Docker network"]
Downloads["<b>Local torrents / libraries</b><br/>/data/jellyfin<br/>Hardlink imports"]
Router["<b>Home router / ISP</b><br/>Encrypted VPN underlay"]
LAN -->|"HTTPS :443"| Traefik LAN -->|"HTTPS :443"| Traefik
Traefik -->|"Application routing"| Apps Traefik -->|"Application routing"| Apps
Traefik -->|"Media management UIs"| Arr Traefik -->|"Media management UIs"| Arr
Arr -->|"/downloads bind / host /mnt/seedbox"| Rclone Traefik -->|"Authentik + qBittorrent login / :8080"| Gluetun
end Gluetun -->|"Web UI / API"| Qbit
Arr -->|"downloads network / gluetun:8080"| Gluetun
subgraph Seed["ULTRA.CC / SEEDBOX"] Arr -->|"Local hardlink imports"| Downloads
Qbit["<b>qBittorrent</b><br/>jayo60013.terra.usbx.me"]
Downloads["<b>Remote download storage</b><br/>terra.usbx.me<br/>downloads/qbittorrent"]
Qbit -->|"Writes downloads"| Downloads Qbit -->|"Writes downloads"| Downloads
Qbit -->|"VPN-only torrent traffic"| Gluetun
Gluetun -->|"Encrypted AirVPN WireGuard"| Router
end end
AirVPN["<b>AirVPN</b><br/>Public VPN exit / reserved peer port"]
Peers["<b>Torrent peers</b>"]
Internet -->|"HTTPS :443"| Nginx Internet -->|"HTTPS :443"| Nginx
Nginx -->|"HTTPS :443 over WireGuard"| Traefik Nginx -->|"HTTPS :443 over WireGuard"| Traefik
Arr -->|"qBittorrent API / endpoint unconfirmed"| Qbit Router -->|"Home ISP / not Mercury"| AirVPN
Rclone -->|"Outbound SFTP / remote file access"| Downloads AirVPN <-->|"Torrent traffic"| Peers
class Internet,LAN infraClient class Internet,LAN,Peers infraClient
class Nginx,Traefik infraEdge class Nginx,Traefik,Router,AirVPN infraEdge
class Apps,Uptime,Arr,Rclone,Qbit,Downloads infraService class Apps,Uptime,Arr,Gluetun,Qbit,Downloads infraService
``` ```
## Cloudflare Tunnel ## Cloudflare Tunnel
@@ -185,28 +213,27 @@ Ingress source: host `/data/cloudflared/config.yaml`, mounted at
| `bookshelf.local.umbra.mom` | Jupiter `192.168.1.56` | | `bookshelf.local.umbra.mom` | Jupiter `192.168.1.56` |
| `ssh.umbra.mom`, `git.umbra.mom` | Cloudflare Tunnel | | `ssh.umbra.mom`, `git.umbra.mom` | Cloudflare Tunnel |
| `uptime.umbra.mom` | Mercury nginx -> `http://127.0.0.1:3001` | | `uptime.umbra.mom` | Mercury nginx -> `http://127.0.0.1:3001` |
| `terra.usbx.me` | Ultra.cc seedbox; rclone SFTP remote | | `qbittorrent.umbra.mom` | Mercury -> Traefik -> Authentik -> Gluetun/qBittorrent `8080`; native login retained |
| `jayo60013.terra.usbx.me` | Provider-hosted qBittorrent UI under `/qbittorrent/` | | `gluetun:8080` | Internal authenticated qBittorrent API on the `downloads` Docker network |
## Seedbox connection ## Download connectivity
The [Ultra.cc seedbox](seedbox.md) runs qBittorrent on `terra.usbx.me`, separate qBittorrent now runs on Jupiter in Gluetun's network namespace. The enabled
from Jupiter and Mercury. Its provider-hosted UI is Gluetun firewall and qBittorrent's `wg0` binding are configured for VPN-only
<https://jayo60013.terra.usbx.me/qbittorrent/>. torrent egress. AirVPN's reserved peer port is allowed through the VPN firewall,
not published on Jupiter or forwarded on the home router. Working downloads
alone do not demonstrate inbound peer reachability or failure isolation.
Jupiter's host-level `rclone-seedbox.service` initiates an outbound SFTP Sonarr/Radarr and optional Prowlarr direct downloads use `gluetun:8080` with
connection to `terra.usbx.me`, user `jayo60013`, using native qBittorrent credentials, not the public Authentik-protected URL.
`/home/jay/.ssh/id_ed25519`. Remote `seedbox:downloads/qbittorrent` is exposed Their ordinary internet routes and Prowlarr/FlareSolverr indexer traffic remain
through FUSE at `/mnt/seedbox`, then bind-mounted at `/downloads` in Radarr outside AirVPN. The Web UI also has a loopback-only `127.0.0.1:8080` publication
and Sonarr. File reads use this mount; download control/removal uses qBittorrent's for private SSH forwarding.
API, not deletion through rclone. The exact configured download-client API
endpoint and SFTP port were not supplied; do not infer them from the UI URL.
This is not a WebDAV mount, scheduled sync, or Mercury/WireGuard/Cloudflare Imports now use local storage and hardlinks, not SFTP/FUSE. The former
Tunnel ingress route. No home-router port forwarding is required for Jupiter's [Seedbox](seedbox.md) page is historical; its service and mount are removed.
outbound SFTP connection. Remote availability and the host mount are dependencies See [Storage](storage.md) for current placement and
for media imports; startup ordering relative to Docker remains unconfirmed. [Local downloads](downloads.md) for the runbook and remaining checks.
See [Storage](storage.md) for remote versus local media placement.
## Mercury ## Mercury
@@ -236,6 +263,11 @@ An internal network alone does not isolate a multi-network container from
egress through its other networks. Empty network entries do not establish egress through its other networks. Empty network entries do not establish
whether they are obsolete or safe to remove. whether they are obsolete or safe to remove.
The newer `downloads` bridge is defined with IPv6 disabled and is not internal.
Gluetun, Traefik, Sonarr, Radarr and Prowlarr attach to it; qBittorrent shares
Gluetun's namespace rather than joining independently. Its subnet was not
recorded. This supplements, rather than re-inspects, the older table.
## Jupiter: repository configuration ## Jupiter: repository configuration
- Traefik publishes TCP `80,443`; HTTP redirects to HTTPS. - Traefik publishes TCP `80,443`; HTTP redirects to HTTPS.
@@ -252,11 +284,12 @@ whether they are obsolete or safe to remove.
[Authentik](authentication.md) serves `auth.umbra.mom` through Traefik to [Authentik](authentication.md) serves `auth.umbra.mom` through Traefik to
`authentik-server:9000`; the server joins the external `traefik` network. `authentik-server:9000`; the server joins the external `traefik` network.
The ingress diagrams show transport, not a universal authentication gate. The ingress diagrams show transport, not a universal authentication gate.
Seven applications use native OIDC; Backrest, Notes, Prowlarr, Radarr and Sonarr Native OIDC integrations are listed on the authentication page; Backrest, Notes,
Prowlarr, Radarr, Sonarr and qBittorrent
use Traefik middleware `authentik@docker` and the embedded outpost. use Traefik middleware `authentik@docker` and the embedded outpost.
Dozzle (`logs.umbra.mom`) now uses OIDC, not forward-auth. Dozzle (`logs.umbra.mom`) now uses OIDC, not forward-auth.
On the five proxy-protected hostnames, a priority-1000 On the six proxy-protected hostnames, a priority-1000
`/outpost.goauthentik.io/` route goes straight to Authentik without forward-auth `/outpost.goauthentik.io/` route goes straight to Authentik without forward-auth
to handle callbacks. Other application requests use their normal routers. to handle callbacks. Other application requests use their normal routers.
The middleware trusts forwarded headers; this is not evidence that the wider The middleware trusts forwarded headers; this is not evidence that the wider
+20 -3
View File
@@ -4,8 +4,10 @@ id: home-server.operations
type: reference type: reference
scope: [jupiter, mercury, design-decisions, monitoring, recovery] scope: [jupiter, mercury, design-decisions, monitoring, recovery]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-23" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "AirVPN local downloads live, Ultra.cc/rclone retired; cost saving and simpler architecture; GBP 56.06 three-year plan ends 2029-10-25; imports/hardlinks confirmed, full isolation checks and backups outstanding, 2026-10-26"
- kind: owner-report - kind: owner-report
reference: "RAID/media tradeoff, CGNAT/public IPv4 rationale, no alerting and running monitoring/log containers, 2026-10-06" reference: "RAID/media tradeoff, CGNAT/public IPv4 rationale, no alerting and running monitoring/log containers, 2026-10-06"
- kind: owner-report - kind: owner-report
@@ -14,7 +16,7 @@ sources:
reference: "OIDC and three-group motivation; Authentik fully deployed and Authelia retired; updated six-directory backup plan; independent recovery custody unchanged, 2026-10-16" reference: "OIDC and three-group motivation; Authentik fully deployed and Authelia retired; updated six-directory backup plan; independent recovery custody unchanged, 2026-10-16"
- kind: owner-report - kind: owner-report
reference: "Notifications received in Discord server Jupiter: Beszel in #beszel-alerts, Backrest in #backrest-alerts, and Mercury Uptime Kuma in #uptimekuma-alerts, 2026-10-23" reference: "Notifications received in Discord server Jupiter: Beszel in #beszel-alerts, Backrest in #backrest-alerts, and Mercury Uptime Kuma in #uptimekuma-alerts, 2026-10-23"
related: [home-server.reference, home-server.host, home-server.mercury, home-server.networking, home-server.storage, home-server.authentication, home-server.backups, home-server.deployment] related: [home-server.reference, home-server.host, home-server.mercury, home-server.downloads, home-server.networking, home-server.storage, home-server.authentication, home-server.backups, home-server.deployment]
update_triggers: [data-priority-change, architecture-change, alerting-change, recovery-test] update_triggers: [data-priority-change, architecture-change, alerting-change, recovery-test]
unknowns: unknowns:
- acceptable-data-loss-and-recovery-order-by-service - acceptable-data-loss-and-recovery-order-by-service
@@ -34,8 +36,9 @@ unknowns:
| Back up important state | Six application directories covered, subject to exclusions; media redundancy is not the objective | | Back up important state | Six application directories covered, subject to exclusions; media redundancy is not the objective |
| Mercury public edge | Static public IPv4; home ISP uses CGNAT | | Mercury public edge | Static public IPv4; home ISP uses CGNAT |
| No residential public ingress | Owner preference to avoid exposing the home IP | | No residential public ingress | Owner preference to avoid exposing the home IP |
| AirVPN instead of Ultra.cc | Live local downloads reduce cost and simplify architecture: no remote seedbox or SFTP/FUSE import dependency; GBP 56.06 prepaid for three years, expires Thursday, 25 October 2029 |
| Authentik instead of Authelia | Native OIDC rather than only forward-auth; retain forward-auth where needed | | Authentik instead of Authelia | Native OIDC rather than only forward-auth; retain forward-auth where needed |
| Three access categories | Admin: owner only, server health/operations; Developers: development services such as Gitea/Portainer; Clients: useful end-user services such as Wardrowbe/Paperless | | Application access | 2026-10-26: replace the former Admin/Developers/Clients groups with manual per-user service bindings; keep `jay` as administrator with access to every configured application; repository prepared, deployment unconfirmed |
RAID 0 still stores important state alongside media: either HDD failure loses RAID 0 still stores important state alongside media: either HDD failure loses
the array; recovery depends on working backups. Owner intent is not evidence the array; recovery depends on working backups. Owner intent is not evidence
@@ -46,6 +49,20 @@ Exact repository group names, app assignments and MFA policy are in
[Authentication](authentication.md). Group access is not the same as application [Authentication](authentication.md). Group access is not the same as application
administrator privileges or Authentik superuser status. administrator privileges or Authentik superuser status.
## Download migration
[Local downloads](downloads.md) are live by owner report on 2026-10-26.
Direct home-ISP egress, both Arr hardlink imports, seeding/removal and the public
UI's Authentik plus qBittorrent login are confirmed. Ultra.cc is
cancelled/expired, retained files are handled and the old mount/service removed.
The subscription saving is approximately GBP 35.31/year before incremental
electricity, compared with the former GBP 4.50/month seedbox.
Remaining operational work: complete peer-ingress, DNS/IPv6 and
VPN-failure/startup/reboot isolation checks, and back up qBittorrent state/defaults
and AirVPN secrets. Normal successful downloads do not prove fail-closed behaviour.
The retired seedbox must not be assumed available for rollback.
## Observability ## Observability
| Facility | Current configuration | | Facility | Current configuration |
+4 -2
View File
@@ -53,8 +53,10 @@ establish local DNS resolution.
Native OIDC through [Authentik](authentication.md); client ID `portainer`; Native OIDC through [Authentik](authentication.md); client ID `portainer`;
issuer `https://auth.umbra.mom/application/o/portainer/`. issuer `https://auth.umbra.mom/application/o/portainer/`.
Both public and local HTTPS hostnames are registered as strict callbacks. Both public and local HTTPS hostnames are registered as strict callbacks.
Application access requires Authentik group `development` (owner's Developers The updated Authentik blueprint grants `jay` direct access, with other users
category); this does not itself assign Portainer administrator permissions. assigned manually per application instead of through the retired `development`
group. Deployment of this access-policy migration is unconfirmed. Admission
does not itself assign Portainer administrator permissions.
OAuth configuration is database/UI state, not configured by the container OAuth configuration is database/UI state, not configured by the container
startup script. The owner reports the integration complete; local-login and startup script. The owner reports the integration complete; local-login and
+25 -4
View File
@@ -4,8 +4,12 @@ id: home-server.seedbox
type: reference type: reference
scope: [seedbox, ultra-cc, qbittorrent, rclone, sftp, media-import] scope: [seedbox, ultra-cc, qbittorrent, rclone, sftp, media-import]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-06" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "Ultra.cc subscription active from 2024-05-25 until retirement, always GBP 4.50/month with no price changes, 2026-10-26"
- kind: owner-report
reference: "Ultra.cc cancelled/expired, retained files handled, rclone-seedbox service and mount removed; local AirVPN downloads live, 2026-10-26"
- kind: owner-report - kind: owner-report
reference: "Ultra.cc plan, remaining capacity, rclone remote/process and enabled systemd unit, 2026-10-06" reference: "Ultra.cc plan, remaining capacity, rclone remote/process and enabled systemd unit, 2026-10-06"
- kind: owner-report - kind: owner-report
@@ -22,7 +26,7 @@ sources:
paths: paths:
- stacks/radarr/docker-compose.yml - stacks/radarr/docker-compose.yml
- stacks/sonarr/docker-compose.yml - stacks/sonarr/docker-compose.yml
related: [home-server.reference, home-server.networking, home-server.storage, home-server.backups] related: [home-server.reference, home-server.downloads, home-server.networking, home-server.storage, home-server.backups]
update_triggers: [hosting-renewal, quota-change, remote-change, mount-change, media-import-change] update_triggers: [hosting-renewal, quota-change, remote-change, mount-change, media-import-change]
unknowns: unknowns:
- total-traffic-allowance-and-reset-period - total-traffic-allowance-and-reset-period
@@ -35,9 +39,26 @@ unknowns:
- seedbox-backup-policy - seedbox-backup-policy
--- ---
# Seedbox # Seedbox (retired)
## Service / subscription **Retired by owner report on 2026-10-26:** Ultra.cc is cancelled/expired,
retained files have been handled, and Jupiter's `rclone-seedbox.service` and
`/mnt/seedbox` FUSE mount are removed. The replacement is
[local qBittorrent through AirVPN](downloads.md), now live with working
Sonarr/Radarr hardlink imports and seeding/removal.
The change reduces subscription cost and simplifies the architecture by removing
remote storage and the SFTP/FUSE import dependency. AirVPN cost GBP 56.06 for
three years, ending **Thursday, 25 October 2029**, versus Ultra.cc's former
GBP 4.50/month.
The Ultra.cc subscription had been active since **2024-05-25**, always at
**GBP 4.50/month**, with no price changes before retirement.
Everything below is a **historical 2026-10-06 snapshot**, retained for reference,
not current service state or a service to recreate.
## Former service / subscription
| Field | Configuration | | Field | Configuration |
| --- | --- | | --- | --- |
+54 -35
View File
@@ -2,10 +2,20 @@
schema_version: 1 schema_version: 1
id: home-server.storage id: home-server.storage
type: reference type: reference
scope: [jupiter, seedbox, disks, raid, filesystems, docker-volumes, remote-storage] scope: [jupiter, downloads, disks, raid, filesystems, docker-volumes, media-import]
sensitivity: private-infrastructure sensitivity: private-infrastructure
last_reviewed: "2026-10-16" last_reviewed: "2026-10-26"
sources: sources:
- kind: owner-report
reference: "Local AirVPN downloads live; Sonarr/Radarr imports, hardlinks and seeding/removal confirmed; retained seedbox files handled and rclone service/mount removed; download-state backups not yet added, 2026-10-26"
- kind: repository
repository: jupiter-stacks
revision: working-tree
base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
paths:
- stacks/downloads/docker-compose.yml
- stacks/sonarr/docker-compose.yml
- stacks/radarr/docker-compose.yml
- kind: owner-report - kind: owner-report
reference: "lsblk filesystem output, RAID level, mount placement and Docker data root, 2026-10-06" reference: "lsblk filesystem output, RAID level, mount placement and Docker data root, 2026-10-06"
- kind: owner-report - kind: owner-report
@@ -25,13 +35,18 @@ sources:
- stacks/authentik/docker-compose.yml - stacks/authentik/docker-compose.yml
- stacks/wardrowbe/docker-compose.yml - stacks/wardrowbe/docker-compose.yml
- stacks/traefik/docker-compose.yml - stacks/traefik/docker-compose.yml
related: [home-server.reference, home-server.host, home-server.seedbox, home-server.portainer, home-server.backups, home-server.operations] related: [home-server.reference, home-server.host, home-server.downloads, home-server.seedbox, home-server.portainer, home-server.backups, home-server.operations]
update_triggers: [disk-change, raid-change, mount-change, volume-change, backup-coverage-change, seedbox-change] update_triggers: [disk-change, raid-change, mount-change, volume-change, backup-coverage-change, seedbox-change]
unknowns: [persistent-mdadm-config-and-initramfs-content, disk-health] unknowns: [persistent-mdadm-config-and-initramfs-content, disk-health]
--- ---
# Storage # Storage
[AirVPN/local downloads](downloads.md) are live by owner report on 2026-10-26.
Downloads and libraries now share local storage, with Sonarr/Radarr hardlink
imports and seeding/removal confirmed. Existing host library paths are unchanged.
The Ultra.cc service and rclone/FUSE mount are retired, simplifying imports.
```mermaid ```mermaid
--- ---
config: config:
@@ -52,14 +67,14 @@ config:
rankSpacing: 45 rankSpacing: 45
--- ---
flowchart LR flowchart LR
subgraph Remote["ULTRA.CC / SEEDBOX"] subgraph Import["JUPITER / LOCAL MEDIA IMPORT"]
SEED[("<b>terra.usbx.me</b><br/>1001 GB allocation<br/>downloads/qbittorrent")] QBIT["<b>qBittorrent</b><br/>Gluetun / AirVPN"]
end TORRENTS[("<b>/data/jellyfin/torrents</b><br/>incomplete / movies / tv")]
ARR["<b>Radarr / Sonarr</b><br/>/data/jellyfin mounted at /media"]
subgraph Import["JUPITER / REMOTE MEDIA IMPORT"] LIBRARY[("<b>/data/jellyfin</b><br/>movies / tv_shows libraries")]
MOUNT["<b>/mnt/seedbox</b><br/>rclone / SFTP / FUSE<br/>Not a local replica"] QBIT -->|"Writes /media/torrents"| TORRENTS
ARR["<b>Radarr / Sonarr</b><br/>Container /downloads"] TORRENTS -->|"Local download source"| ARR
MOUNT -->|"Bind-mounted download source"| ARR ARR -->|"Hardlink imports / same filesystem"| LIBRARY
end end
subgraph Array["HDD ARRAY / APPLICATION DATA"] subgraph Array["HDD ARRAY / APPLICATION DATA"]
@@ -88,41 +103,41 @@ flowchart LR
ROOT --> CACHE ROOT --> CACHE
end end
SEED -->|"Remote reads / SFTP via rclone"| MOUNT DATA -->|"Backs torrent storage"| TORRENTS
ARR -->|"Import to /data/jellyfin/movies or tv_shows"| DATA DATA -->|"Backs organised libraries"| LIBRARY
class A,B,SSD,DATA,ROOT,SEED infraStorage class A,B,SSD,DATA,ROOT,TORRENTS,LIBRARY infraStorage
class RAID infraCloud class RAID infraCloud
class EFI,SWAP infraClient class EFI,SWAP infraClient
class DOCKER,CACHE,MOUNT,ARR infraService class DOCKER,CACHE,QBIT,ARR infraService
``` ```
RAID 0: striping; no redundancy; either HDD failure loses the array. RAID 0: striping; no redundancy; either HDD failure loses the array.
## Seedbox storage / imports ## Local downloads / imports
The [Ultra.cc seedbox](seedbox.md) is separate remote storage, not part of The current path is entirely on Jupiter's HDD array:
Jupiter's RAID or SSD. Host `terra.usbx.me`, plan `Lancer-v2`: 1001 GB allocation,
984 GB available in the supplied 2026-10-06 snapshot.
```text ```text
/home/jayo60013/downloads/qbittorrent (seedbox) qBittorrent -> /data/jellyfin/torrents/{incomplete,movies,tv}
-> rclone remote seedbox:downloads/qbittorrent -> Sonarr/Radarr via /data/jellyfin:/media
-> /mnt/seedbox (Jupiter SFTP/FUSE mount) -> hardlinks in /data/jellyfin/{movies,tv_shows}
-> /downloads (Radarr / Sonarr bind mount)
-> /data/jellyfin/{movies,tv_shows} (imported library on HDD array)
``` ```
`rclone-seedbox.service` manages the mount; it is not a scheduled sync or full Sonarr's library root is `/media/tv_shows`; Radarr's is `/media/movies`.
local replica. `--vfs-cache-mode writes` streams read-only opens; the cache qBittorrent receives only the torrents subtree at `/media/torrents`, not the
location and size limit are unconfirmed. Cross-filesystem hardlinks to the organised libraries. Jellyfin retains `/data/jellyfin:/media`; its library roots
local libraries are impossible. Host remounts do not automatically propagate must exclude the torrent folders.
through the containers' `rprivate` binds.
The six-directory Backrest plan does not cover the seedbox or media libraries; Hardlinks let imported files remain available while torrents seed without a
the provider's own backup policy is unknown. FUSE-reported capacity does not second full data copy. Removing one name does not remove the data while another
establish the account quota. Import/removal behaviour and mount details remain link remains; hardlinks are not independent copies or backups. The old remote
documented on the [Seedbox](seedbox.md) page. mount could not support cross-filesystem hardlinks to the local libraries.
The six-directory Backrest plan does not cover media, torrent data, qBittorrent
state/defaults or VPN secrets. The owner confirms the latter recovery gap
remains. Historical remote storage details are on [Seedbox (retired)](seedbox.md);
retained files are handled and its mount/service are removed.
## Filesystems ## Filesystems
@@ -166,14 +181,18 @@ UUID=4781ea5d-fba5-438d-8d97-6a0801669ca1 none swap sw 0 0
``` ```
Observed `/data`: `rw,relatime,stripe=256`; `/tmp`: tmpfs. Observed `/data`: `rw,relatime,stripe=256`; `/tmp`: tmpfs.
Seedbox FUSE mount is service-managed, not listed in fstab. The former seedbox FUSE mount was service-managed, not listed in fstab; it has
now been removed.
## Placement ## Placement
| Host path | Backing / purpose | | Host path | Backing / purpose |
| --- | --- | | --- | --- |
| `/data/<service>` | HDD array; service bind mounts | | `/data/<service>` | HDD array; service bind mounts |
| `/mnt/seedbox` | Remote SFTP/FUSE mount; [seedbox](seedbox.md); not a local replica | | `/data/jellyfin/torrents/{incomplete,movies,tv}` | HDD array; local qBittorrent downloads |
| `/data/jellyfin/{movies,tv_shows}` | HDD array; organised media libraries; hardlink imports |
| `/data/qbittorrent/{config,defaults}` | HDD array; client state and startup defaults/scripts; not backed up |
| `/data/gluetun/secrets` | HDD array; root-restricted AirVPN WireGuard secrets; not backed up |
| `/home/jay/data/backrest/cache` | SSD; Backrest cache | | `/home/jay/data/backrest/cache` | SSD; Backrest cache |
| `/home/jay/data/jellyfin/cache` | SSD; Jellyfin cache | | `/home/jay/data/jellyfin/cache` | SSD; Jellyfin cache |
| `/var/lib/docker` | SSD; Docker state and default local named volumes | | `/var/lib/docker` | SSD; Docker state and default local named volumes |
+2 -1
View File
@@ -14,7 +14,8 @@ nav = [
{ "Reference" = "home-server/index.md" }, { "Reference" = "home-server/index.md" },
{ "Host" = "home-server/host.md" }, { "Host" = "home-server/host.md" },
{ "Mercury VPS" = "home-server/mercury.md" }, { "Mercury VPS" = "home-server/mercury.md" },
{ "Seedbox" = "home-server/seedbox.md" }, { "Local downloads / AirVPN" = "home-server/downloads.md" },
{ "Seedbox (retired)" = "home-server/seedbox.md" },
{ "Portainer" = "home-server/portainer.md" }, { "Portainer" = "home-server/portainer.md" },
{ "Deployment" = "home-server/deployment.md" }, { "Deployment" = "home-server/deployment.md" },
{ "Notes" = "home-server/notes.md" }, { "Notes" = "home-server/notes.md" },