--- schema_version: 1 id: home-server.networking type: reference scope: [jupiter, mercury, airvpn, downloads, dns, ingress, wireguard, cloudflare] sensitivity: private-infrastructure last_reviewed: "2026-10-26" 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 reference: "Network topology, Mercury nginx/iptables/fail2ban output, LAN DNS, 2026-10-06" - kind: owner-report reference: "Cloudflare ingress YAML and client SSH configurations, 2026-10-06" - kind: owner-report reference: "CGNAT rationale, Docker network and container inspection, 2026-10-06" - kind: owner-report reference: "Ultra.cc hostname, qBittorrent UI, SFTP rclone remote/systemd unit and Radarr/Sonarr bind mounts, 2026-10-06" - kind: owner-report reference: "Authentik fully deployed with all listed app integrations and Authelia retired, 2026-10-16" - kind: repository repository: jupiter-stacks revision: 610e325ef6a98850511ce7a089b0b9a77bfecf15 paths: - stacks/traefik/docker-compose.yml - stacks/cloudflared/docker-compose.yml - stacks/gitea/docker-compose.yml - stacks/jellyfin/docker-compose.yml - stacks/audiobookshelf/docker-compose.yml - kind: repository repository: jupiter-stacks revision: d09df456ad331b8beb9a40615114ea8aae2dced5 paths: - stacks/authentik/docker-compose.yml - stacks/authentik/blueprints/jupiter.yaml 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] unknowns: - public-dns-record-types-and-cloudflare-proxy-status - cloudflare-access-applications-and-login-policies - wireguard-allowedips-and-keepalive - jupiter-firewall-policy - traefik-forwarded-header-trust-configuration - complete-airvpn-failure-dns-and-ipv6-isolation-results --- # Networking ## 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 --- 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["Public clients"] subgraph VPS["MERCURY / PUBLIC EDGE"] Nginx["nginx
185.230.217.66
WireGuard 10.0.0.1"] Uptime["Uptime service
127.0.0.1:3001"] Nginx -->|"uptime.umbra.mom / HTTP"| Uptime end subgraph Home["JUPITER / HOME SERVER"] LAN["LAN clients
Jellyfin / Bookshelf local DNS"] Traefik["Traefik
192.168.1.56
WireGuard 10.0.0.2"] Apps["Application containers
Docker network: traefik"] Arr["Radarr / Sonarr
Download control / media imports"] Qbit["qBittorrent
Shared Gluetun namespace"] Gluetun["Gluetun
WireGuard / firewall
downloads Docker network"] Downloads["Local torrents / libraries
/data/jellyfin
Hardlink imports"] Router["Home router / ISP
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["AirVPN
Public VPN exit / reserved peer port"] Peers["Torrent peers"] 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 ```mermaid --- 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["SSH client
Host jupiter / user jay"] Git["Git over SSH
Host git.umbra.mom / user git"] Cloud["Cloudflare Tunnel edge
Access policy unconfirmed"] subgraph Home["JUPITER / HOME SERVER"] Connector["cloudflared
Locally configured ingress"] SSH["Host sshd
192.168.1.56:22"] Gitea["Gitea SSH
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`. ```sshconfig 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](seedbox.md) page is historical; its service and mount are removed. See [Storage](storage.md) for current placement and [Local downloads](downloads.md) for the runbook and remaining checks. ## Mercury [Mercury VPS](mercury.md): 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 network `traefik`. - File provider: `/data/traefik/dynamic`. - ACME: Let's Encrypt; Cloudflare DNS-01; `/data/traefik/acme/acme.json`; apex + `*.umbra.mom` certificate requested. - HTTPS fallback: priority `1`; unmatched non-apex hosts redirect to `https://umbra.mom`. - `cloudflared`: `/data/cloudflared` -> `/etc/cloudflared`; stack-local bridge `cloudflare`; no published ports. ## Authentication routing [Authentik](authentication.md) 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.