14 KiB
schema_version, id, type, scope, sensitivity, last_reviewed, sources, related, update_triggers, unknowns
| schema_version | id | type | scope | sensitivity | last_reviewed | sources | related | update_triggers | unknowns | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | home-server.networking | reference |
|
private-infrastructure | 2026-10-26 |
|
|
|
|
Networking
AirVPN downloads
VPN-isolated local downloads 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.
HTTPS ingress / local downloads
---
config:
themeCSS: |
.node rect { rx: 8px; ry: 8px; stroke-width: 1.5px; }
.cluster rect { fill: var(--infra-zone) !important; stroke: var(--infra-border) !important; stroke-dasharray: 5 5; rx: 12px; ry: 12px; }
.label, .nodeLabel, .cluster-label { color: var(--infra-text) !important; }
.edgeLabel, .edgeLabel p { background-color: var(--infra-zone) !important; color: var(--infra-text) !important; }
.flowchart-link { stroke: var(--infra-line) !important; }
marker path { fill: var(--infra-line) !important; stroke: var(--infra-line) !important; }
.infraClient rect { fill: var(--infra-client-fill) !important; stroke: var(--infra-client-stroke) !important; }
.infraEdge rect { fill: var(--infra-edge-fill) !important; stroke: var(--infra-edge-stroke) !important; }
.infraService rect { fill: var(--infra-service-fill) !important; stroke: var(--infra-service-stroke) !important; }
flowchart:
curve: basis
nodeSpacing: 35
rankSpacing: 55
---
flowchart TB
Internet["<b>Public clients</b>"]
subgraph VPS["MERCURY / PUBLIC EDGE"]
Nginx["<b>nginx</b><br/>185.230.217.66<br/>WireGuard 10.0.0.1"]
Uptime["<b>Uptime service</b><br/>127.0.0.1:3001"]
Nginx -->|"uptime.umbra.mom / HTTP"| Uptime
end
subgraph Home["JUPITER / HOME SERVER"]
LAN["<b>LAN clients</b><br/>Jellyfin / Bookshelf local DNS"]
Traefik["<b>Traefik</b><br/>192.168.1.56<br/>WireGuard 10.0.0.2"]
Apps["<b>Application containers</b><br/>Docker network: traefik"]
Arr["<b>Radarr / Sonarr</b><br/>Download control / media imports"]
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
Traefik -->|"Application routing"| Apps
Traefik -->|"Media management UIs"| Arr
Traefik -->|"Authentik + qBittorrent login / :8080"| Gluetun
Gluetun -->|"Web UI / API"| Qbit
Arr -->|"downloads network / gluetun:8080"| Gluetun
Arr -->|"Local hardlink imports"| Downloads
Qbit -->|"Writes downloads"| Downloads
Qbit -->|"VPN-only torrent traffic"| Gluetun
Gluetun -->|"Encrypted AirVPN WireGuard"| Router
end
AirVPN["<b>AirVPN</b><br/>Public VPN exit / reserved peer port"]
Peers["<b>Torrent peers</b>"]
Internet -->|"HTTPS :443"| Nginx
Nginx -->|"HTTPS :443 over WireGuard"| Traefik
Router -->|"Home ISP / not Mercury"| AirVPN
AirVPN <-->|"Torrent traffic"| Peers
class Internet,LAN,Peers infraClient
class Nginx,Traefik,Router,AirVPN infraEdge
class Apps,Uptime,Arr,Gluetun,Qbit,Downloads infraService
Cloudflare Tunnel
---
config:
themeCSS: |
.node rect { rx: 8px; ry: 8px; stroke-width: 1.5px; }
.cluster rect { fill: var(--infra-zone) !important; stroke: var(--infra-border) !important; stroke-dasharray: 5 5; rx: 12px; ry: 12px; }
.label, .nodeLabel, .cluster-label { color: var(--infra-text) !important; }
.edgeLabel, .edgeLabel p { background-color: var(--infra-zone) !important; color: var(--infra-text) !important; }
.flowchart-link { stroke: var(--infra-line) !important; }
marker path { fill: var(--infra-line) !important; stroke: var(--infra-line) !important; }
.infraClient rect { fill: var(--infra-client-fill) !important; stroke: var(--infra-client-stroke) !important; }
.infraCloud rect { fill: var(--infra-cloud-fill) !important; stroke: var(--infra-cloud-stroke) !important; }
.infraEdge rect { fill: var(--infra-edge-fill) !important; stroke: var(--infra-edge-stroke) !important; }
.infraService rect { fill: var(--infra-service-fill) !important; stroke: var(--infra-service-stroke) !important; }
flowchart:
curve: basis
nodeSpacing: 35
rankSpacing: 45
---
flowchart TB
Shell["<b>SSH client</b><br/>Host jupiter / user jay"]
Git["<b>Git over SSH</b><br/>Host git.umbra.mom / user git"]
Cloud["<b>Cloudflare Tunnel edge</b><br/>Access policy unconfirmed"]
subgraph Home["JUPITER / HOME SERVER"]
Connector["<b>cloudflared</b><br/>Locally configured ingress"]
SSH["<b>Host sshd</b><br/>192.168.1.56:22"]
Gitea["<b>Gitea SSH</b><br/>192.168.1.56:2222"]
Connector -->|"ssh.umbra.mom / SSH :22"| SSH
Connector -->|"git.umbra.mom / SSH :2222"| Gitea
end
Shell -->|"cloudflared access ssh / ssh.umbra.mom"| Cloud
Git -->|"cloudflared access ssh / git.umbra.mom"| Cloud
Cloud <-->|"Tunnel traffic / initiated outbound by Jupiter"| Connector
class Shell,Git infraClient
class Cloud infraCloud
class Connector infraEdge
class SSH,Gitea infraService
Client cloudflared transports SSH through Cloudflare; Jupiter's connector opens
the outbound tunnel. Origins still perform SSH authentication. No Mercury,
WireGuard, or Traefik hop on this path; no home-router port forwarding.
| Ingress hostname | Origin | Client SSH user |
|---|---|---|
ssh.umbra.mom |
ssh://192.168.1.56:22 |
jay |
git.umbra.mom |
ssh://192.168.1.56:2222 |
git |
| Unmatched | http_status:404 |
N/A |
Both client configurations use IdentityFile ~/.ssh/id_ed25519.
Host jupiter
User jay
IdentityFile ~/.ssh/id_ed25519
ProxyCommand cloudflared access ssh --hostname ssh.umbra.mom
Host git.umbra.mom
User git
IdentityFile ~/.ssh/id_ed25519
ProxyCommand cloudflared access ssh --hostname %h
Local tunnel configuration is separate from Cloudflare Access applications.
Access login/provider/allow rules remain unconfirmed; ProxyCommand alone
does not establish enforcement.
Ingress source: host /data/cloudflared/config.yaml, mounted at
/etc/cloudflared/config.yaml.
DNS / routes
| DNS / route | Destination |
|---|---|
| Public service ingress | Mercury 185.230.217.66 |
jellyfin.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 |
uptime.umbra.mom |
Mercury nginx -> http://127.0.0.1:3001 |
qbittorrent.umbra.mom |
Mercury -> Traefik -> Authentik -> Gluetun/qBittorrent 8080; native login retained |
gluetun:8080 |
Internal authenticated qBittorrent API on the downloads Docker network |
Download connectivity
qBittorrent now runs on Jupiter in Gluetun's network namespace. The enabled
Gluetun firewall and qBittorrent's wg0 binding are configured for VPN-only
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.
Sonarr/Radarr and optional Prowlarr direct downloads use gluetun:8080 with
native qBittorrent credentials, not the public Authentik-protected URL.
Their ordinary internet routes and Prowlarr/FlareSolverr indexer traffic remain
outside AirVPN. The Web UI also has a loopback-only 127.0.0.1:8080 publication
for private SSH forwarding.
Imports now use local storage and hardlinks, not SFTP/FUSE. The former Seedbox page is historical; its service and mount are removed. See Storage for current placement and Local downloads for the runbook and remaining checks.
Mercury
Mercury VPS: native nginx; WireGuard server 10.0.0.1/24;
Jupiter client 10.0.0.2/24. Hosting, TLS, firewall and fail2ban details are
maintained on that page.
Home ISP uses CGNAT. Mercury supplies a static public IPv4 and forwards over WireGuard; owner preference is to avoid public ingress via the residential IP.
Observed Docker networks
Snapshot from supplied inspection, not fixed-address configuration. Container IPs may change; use Docker service names.
| Network | IPv4 subnet | Internal | Observed role |
|---|---|---|---|
traefik |
172.18.0.0/16 |
No | Reverse proxy and application ingress |
gitea_network |
172.23.0.0/16 |
No | Gitea, runner, notes builder, Havox sync |
cloudflared_cloudflare |
172.26.0.0/16 |
No | Tunnel connector |
gitea_data |
192.168.96.0/20 |
Yes | Gitea and PostgreSQL |
paperless_data |
192.168.112.0/20 |
Yes | Paperless, PostgreSQL, Redis |
dozzle_dozzle |
172.27.0.0/16 |
Yes | Dozzle and socket proxy |
Cloudflared's observed 172.26.0.2 matches the supplied proxied SSH login source.
An internal network alone does not isolate a multi-network container from
egress through its other networks. Empty network entries do not establish
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
- Traefik publishes TCP
80,443; HTTP redirects to HTTPS. - Docker provider: opt-in
traefik.enable=true; external networktraefik. - File provider:
/data/traefik/dynamic. - ACME: Let's Encrypt; Cloudflare DNS-01;
/data/traefik/acme/acme.json; apex +*.umbra.momcertificate requested. - HTTPS fallback: priority
1; unmatched non-apex hosts redirect tohttps://umbra.mom. cloudflared:/data/cloudflared->/etc/cloudflared; stack-local bridgecloudflare; no published ports.
Authentication routing
Authentik serves auth.umbra.mom through Traefik to
authentik-server:9000; the server joins the external traefik network.
The ingress diagrams show transport, not a universal authentication gate.
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.
Dozzle (logs.umbra.mom) now uses OIDC, not forward-auth.
On the six proxy-protected hostnames, a priority-1000
/outpost.goauthentik.io/ route goes straight to Authentik without forward-auth
to handle callbacks. Other application requests use their normal routers.
The middleware trusts forwarded headers; this is not evidence that the wider
Mercury/Traefik forwarded-header trust chain is configured.
Authentik also publishes 127.0.0.1:9000 for private host access.
Repository-defined networks (not part of the older observed-network snapshot):
authentik-data is internal and connects PostgreSQL, server and worker;
the worker also joins authentik-egress. The server's additional traefik
attachment means the internal data network is not complete egress isolation.