Files
nixfiles/docs/boxes/home/river.md
T
jackos1998 a7ea91f529 docs: Document the boxes
Add a top-level `README.md` mapping the boxes and per-machine docs under
`docs/boxes/` (grouped `colony/`, `home/`, `misc/`), one file per host, VM and
container documenting role, services and networking with source pointers.

Also point `AGENTS.md` at the new docs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 22:45:20 +01:00

1.0 KiB

river

One of the two home routers. river is a VM on palace; it forms a high-availability pair with the standalone stream.

Role

Everything in routing-common:

  • VRRP/keepalived failover with stream (keepalived.nix) — one router is master at a time, sharing virtual IPs.
  • DHCP via kea (kea.nix), router advertisements via radvd (radvd.nix).
  • DNS (dns.nix) — local resolver with a blocklist (dns-blocklist.txt) and a periodic update script.
  • NAT / firewall for the home LAN, with policy routing.
  • AS211024 L2 mesh link back to colony/estuary (and the other edge routers), so home and colony networks interconnect.

See stream.md for the other half of the pair.