update notes for airvpn
This commit is contained in:
13 files changed
+504
-154
No files matched your search
@@ -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.
|
||||||
|
|||||||
@@ -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`,
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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.
|
||||||
@@ -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.
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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 |
|
||||||
|
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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 |
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
@@ -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
@@ -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" },
|
||||||
|
|||||||
Reference in new issue
Block a user