---
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.