--- schema_version: 1 id: home-server.networking type: reference scope: [jupiter, mercury, dns, ingress, wireguard, cloudflare] sensitivity: private-infrastructure last_reviewed: "2026-10-27" sources: - kind: owner-report reference: "DNS/Cloudflare/network snapshots 2026-10-06; ingress cutover verified 2026-10-27" - kind: live-inspection reference: "Traefik/nginx configuration, source rejection, keepalive, WebSockets and tunnel MTU checked 2026-10-27; Immich not running" - kind: repository repository: jupiter-stacks revision: 12fb1b96e01fc062fdce4c216f11eb5d7ce716ed paths: [stacks/traefik/docker-compose.yml, stacks/cloudflared/docker-compose.yml, mercury/nginx/conf.d/upstreams.conf, mercury/nginx/umbra.mom, mercury/nginx/john.gatward.dev, mercury/nginx/samstoreymusic.com] related: [home-server.mercury, home-server.downloads, home-server.authentication, home-server.deployment] update_triggers: [dns-change, proxy-change, tunnel-change, firewall-change, certificate-change] unknowns: [public-dns-record-types-and-cloudflare-proxy-status, cloudflare-access-policies, wireguard-allowedips-and-keepalive, jupiter-firewall-policy] --- # Networking ## Application ingress ```mermaid --- config: themeCSS: | text,.nodeLabel,.cluster-label { fill:var(--infra-text);color:var(--infra-text); } .edgeLabel,.edgeLabel p { background:var(--infra-zone);color:var(--infra-text); } .flowchart-link { stroke:var(--infra-line); } marker path { fill:var(--infra-line);stroke:var(--infra-line); } .cluster rect { fill:var(--infra-zone);stroke:var(--infra-border);stroke-dasharray:5 5;rx:12px;ry:12px; } .cluster span,.cluster text { color:var(--infra-text)!important;fill:var(--infra-text)!important; } .infraClient rect { fill:var(--infra-client-fill);stroke:var(--infra-client-stroke);rx:8px;ry:8px; } .infraEdge rect { fill:var(--infra-edge-fill);stroke:var(--infra-edge-stroke);rx:8px;ry:8px; } .infraService rect { fill:var(--infra-service-fill);stroke:var(--infra-service-stroke);rx:8px;ry:8px; } --- flowchart TB accTitle: Public and LAN application ingress accDescr: Public HTTPS terminates at Mercury; HTTP crosses encrypted WireGuard to Jupiter. LAN HTTPS bypasses Mercury. Public["Public clients"]:::infraClient LAN["LAN clients"]:::infraClient subgraph Mercury["MERCURY / PUBLIC EDGE"] Edge["nginx
185.230.217.66
WG 10.0.0.1"]:::infraEdge Kuma["Uptime Kuma
127.0.0.1:3001"]:::infraService end subgraph Jupiter["JUPITER / HOME"] Proxy["Traefik
LAN 192.168.1.56
WG 10.0.0.2"]:::infraEdge Apps["Application containers"]:::infraService end Public -->|"HTTPS :443"| Edge Edge -->|"HTTP :8081 / encrypted WireGuard"| Proxy LAN -->|"HTTPS :443"| Proxy Proxy -->|"HTTP / Docker networks"| Apps Edge -->|"uptime.umbra.mom / HTTP"| Kuma ``` - Cutover verified by owner **2026-10-27**; browser/OIDC URLs remain HTTPS. - CGNAT requires Mercury's public IPv4; no residential public ingress. - Admin hostnames are still public: the tunnel listener is **not private admin access**. - Torrent egress uses a separate path: [AirVPN](downloads.md#current-topology). ### Listener and trust boundaries | Traefik entrypoint | Behaviour | | --- | --- | | `http`, TCP 80 | Redirect to HTTPS; not Mercury's upstream | | `https`, TCP 443 | TLS + `letsencrypt` defaults; LAN access and transport rollback | | `wireguard`, `10.0.0.2:8081` | HTTP; `mercury-only@docker` admits TCP source `10.0.0.1/32` only | - Public routers: `entrypoints=https,wireguard`; **no router-level TLS settings**. - Local-only routers: HTTPS only, explicit TLS. Separate HTTPS/WireGuard fallbacks redirect unmatched non-apex hosts to `https://umbra.mom` at priority `1`. - Forwarded headers trusted only from `10.0.0.1/32` on `https` and `wireguard`. - nginx sets `Host`, `X-Forwarded-Host`, `X-Forwarded-Port`, `X-Forwarded-Proto`, `X-Real-IP` and `X-Forwarded-For`; client IP is `$remote_addr`, not an appended untrusted chain. - Admission uses connection source, **not** `X-Forwarded-For`; forged headers do not bypass the allowlist. - Security-header middleware: `sslProxyHeaders.X-Forwarded-Proto=https` preserves HSTS on the HTTP hop. - Docker provider: opt-in labels, network `traefik`; file provider: `/data/traefik/dynamic`; custom certificates: `/data/traefik/certs`. - ACME: Cloudflare DNS-01; `/data/traefik/acme/acme.json`; `umbra.mom` + `*.umbra.mom`. - Authentication is per application/router, not a universal gate: [Authentication](authentication.md). ### nginx upstream - Shared `jupiter_backend`: `10.0.0.2:8081`; HTTP/1.1; **16 cached idle connections per worker**, not a concurrency limit. - `Connection` cleared for normal requests and registry `/v2/`; `upgrade` only for WebSockets. - Config: `/etc/nginx/conf.d/upstreams.conf` + three domain files in `sites-available/`; `nginx.conf` must include `conf.d/*.conf` and `sites-enabled/*` inside `http`. - Gitea `/v2/`: unlimited body; `900s` proxy timeouts. - MTU **1420** on both WireGuard interfaces; full-size non-fragmenting probes passed, approximately **7-8 ms** RTT. No sustained throughput/CPU benchmark. - Rollout and rollback: [Deployment](deployment.md#ingress-transport-deployment-and-rollback). ## SSH / Cloudflare Tunnel ```mermaid --- config: themeCSS: | text,.nodeLabel { fill:var(--infra-text);color:var(--infra-text); } .edgeLabel,.edgeLabel p { background:var(--infra-zone);color:var(--infra-text); } .flowchart-link { stroke:var(--infra-line); } marker path { fill:var(--infra-line);stroke:var(--infra-line); } .infraClient rect { fill:var(--infra-client-fill);stroke:var(--infra-client-stroke);rx:8px;ry:8px; } .infraCloud rect { fill:var(--infra-cloud-fill);stroke:var(--infra-cloud-stroke);rx:8px;ry:8px; } .infraEdge rect { fill:var(--infra-edge-fill);stroke:var(--infra-edge-stroke);rx:8px;ry:8px; } .infraService rect { fill:var(--infra-service-fill);stroke:var(--infra-service-stroke);rx:8px;ry:8px; } --- flowchart LR accTitle: SSH through Cloudflare, separate from application ingress accDescr: The client uses cloudflared; Jupiter's outbound connector reaches host SSH or Gitea SSH without Mercury or Traefik. Client["SSH client
cloudflared access ssh"]:::infraClient Edge["Cloudflare edge"]:::infraCloud Tunnel["Jupiter cloudflared
outbound connector"]:::infraEdge Host["Host sshd
192.168.1.56:22"]:::infraService Git["Gitea SSH
192.168.1.56:2222"]:::infraService Client --> Edge <--> Tunnel Tunnel -->|"ssh.umbra.mom"| Host Tunnel -->|"git.umbra.mom"| Git ``` - No Mercury, WireGuard, Traefik or home-router port forwarding on this path. - Connector config: `/data/cloudflared/config.yaml` -> `/etc/cloudflared/config.yaml`; unmatched ingress: `http_status:404`. - Cloudflare Access login/allow policies remain unconfirmed; SSH origins still authenticate users. ```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 ``` ## DNS | Names | Destination | | --- | --- | | Public application names | Mercury `185.230.217.66` | | `jellyfin.local.umbra.mom`, `bookshelf.local.umbra.mom` | Jupiter LAN `192.168.1.56`; bypass Mercury | | `ssh.umbra.mom`, `git.umbra.mom` | Cloudflare Tunnel | ## Docker networks 2026-10-06 supplied snapshot; use service names, not container IPs. | Network | Subnet | Internal | Role | | --- | --- | --- | --- | | `traefik` | `172.18.0.0/16` | No | Application ingress | | `gitea_network` | `172.23.0.0/16` | No | Gitea, runner, builder, Havox | | `cloudflared_cloudflare` | `172.26.0.0/16` | No | Tunnel connector | | `gitea_data` | `192.168.96.0/20` | Yes | Gitea/PostgreSQL | | `paperless_data` | `192.168.112.0/20` | Yes | Paperless/PostgreSQL/Redis | | `dozzle_dozzle` | `172.27.0.0/16` | Yes | Dozzle/socket proxy | - Newer networks: [Downloads](downloads.md), [Notes build](notes.md#networks-and-webhook-allowlist), [Authentik](authentication.md#state-secrets); not part of this snapshot. - `internal` does not block egress through a container's other networks; unused-looking networks are not automatically safe to delete.