chore(docs,nix): fix stale 'localhost via shared netns' claims in forge/matrix
Agents in private netns can't reach host loopback directly; they use forge.<domain> and matrix.<domain> via the gateway. Update four locations that still claimed direct loopback access: - hive-forge.nix: module header + openFirewall description - hive-matrix.nix: openFirewall description - docs/matrix.md: container design bullet + openFirewall section
This commit is contained in:
parent
d7bed0052c
commit
23f13d9e71
3 changed files with 14 additions and 15 deletions
|
|
@ -17,10 +17,9 @@ Same shape as [`gateway.md::hive-forge container shape`](gateway.md):
|
||||||
operator already runs on the host — separate systemd namespace,
|
operator already runs on the host — separate systemd namespace,
|
||||||
separate state dir.
|
separate state dir.
|
||||||
- Container shares the host network namespace
|
- Container shares the host network namespace
|
||||||
(`privateNetwork = false`) so agents reach tuwunel at
|
(`privateNetwork = false`) for state + systemd-unit isolation. Agents
|
||||||
`http://localhost:<httpPort>` without extra plumbing — the
|
reach the homeserver at `matrix.<domain>` via the gateway (agents
|
||||||
nixos-container is here for state + systemd-unit isolation, not
|
run in private netns and can't access host loopback directly).
|
||||||
network isolation.
|
|
||||||
- Persistent state at
|
- Persistent state at
|
||||||
`/var/lib/nixos-containers/hive-matrix/var/lib/matrix-tuwunel/`
|
`/var/lib/nixos-containers/hive-matrix/var/lib/matrix-tuwunel/`
|
||||||
survives container restart / host reboot. To wipe, destroy the
|
survives container restart / host reboot. To wipe, destroy the
|
||||||
|
|
@ -52,9 +51,9 @@ sub-domain from the user-facing identifier.
|
||||||
|
|
||||||
## Default-closed firewall
|
## Default-closed firewall
|
||||||
|
|
||||||
`openFirewall` defaults to `false` (secure-by-default): the
|
`openFirewall` defaults to `false` (secure-by-default): the host
|
||||||
homeserver is reachable from the host + every agent container via
|
reaches the homeserver on loopback, and agent containers reach it
|
||||||
loopback either way (shared netns), so the firewall hole only
|
at `matrix.<domain>` via the gateway — so the firewall hole only
|
||||||
matters for access from *outside* the host. Flip to `true` when
|
matters for access from *outside* the host. Flip to `true` when
|
||||||
announcing the homeserver to other hives or when an external matrix
|
announcing the homeserver to other hives or when an external matrix
|
||||||
client needs to reach the client-server API directly.
|
client needs to reach the client-server API directly.
|
||||||
|
|
|
||||||
|
|
@ -56,8 +56,8 @@ let
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
# Private Forgejo in a `hive-forge` nixos-container, shared host
|
# Private Forgejo in a `hive-forge` nixos-container, shared host
|
||||||
# netns so agents reach it on loopback. State at
|
# netns. Agents reach it at `forge.<domain>` via the gateway. State
|
||||||
# `/var/lib/nixos-containers/hive-forge/var/lib/forgejo/` survives
|
# at `/var/lib/nixos-containers/hive-forge/var/lib/forgejo/` survives
|
||||||
# restart. See `docs/gateway.md::hive-forge container shape`.
|
# restart. See `docs/gateway.md::hive-forge container shape`.
|
||||||
|
|
||||||
# The internal forge is mandatory — it's the canonical store for the
|
# The internal forge is mandatory — it's the canonical store for the
|
||||||
|
|
|
||||||
|
|
@ -173,12 +173,12 @@ in
|
||||||
example = true;
|
example = true;
|
||||||
description = ''
|
description = ''
|
||||||
Open `httpPort` in the host firewall. Off by default
|
Open `httpPort` in the host firewall. Off by default
|
||||||
(secure-by-default): the homeserver is reachable from the
|
(secure-by-default): the host reaches the homeserver on
|
||||||
host + every agent container via `localhost` either way
|
loopback, and agent containers reach it at `matrix.<domain>`
|
||||||
(shared netns), so the firewall open only matters for access
|
via the gateway — so the firewall open only matters for
|
||||||
from outside the host. Flip to `true` when announcing the
|
access from outside the host. Flip to `true` when announcing
|
||||||
homeserver to other hives or when an external matrix client
|
the homeserver to other hives or when an external matrix
|
||||||
needs to reach the client-server API directly.
|
client needs to reach the client-server API directly.
|
||||||
|
|
||||||
**Breaking change**: this used to default to `true`. If you
|
**Breaking change**: this used to default to `true`. If you
|
||||||
relied on the old default for external reach, add
|
relied on the old default for external reach, add
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue