Files
nixfiles/docs/sites/home
jackos1998 0c6928f7ae
Update docs / update (push) Successful in 1m14s
CI / Check, build and cache nixfiles (push) Successful in 56m6s
docs/home: Add 5G WWAN modem reference
Notes from bench-testing the Quectel RM500U-EA on tower, bought to
eventually replace stream's Virgin Media WAN. Like the switches and
APs, the module is configured out-of-band and is not referenced by
the flake.

Records what it takes to connect at all: the module must be switched
from its stock NCM composition to MBIM, since under NCM the PDP
context activates but the cdc_ncm link never raises carrier; and the
connect only succeeds with the network-expanded APN read off the
default-attach bearer, as IPv4.

Also flags the two consequences for stream: the SIM is CGNAT so it
cannot carry the public lease stream's WAN currently publishes, and
the bearer reports a /8 that would cover Tailscale's 100.64.0.0/10
if configured literally.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-05 22:57:42 +01:00
..
2026-08-02 11:42:09 +01:00
2026-08-02 00:12:57 +01:00
2026-08-02 00:12:57 +01:00
2026-08-05 22:57:42 +01:00

Home site

The home network (domain h.nul.ie): a redundant pair of routers in front of a VM host, an NVMe-oF storage target, an IoT container host, and a workstation. The two routers — river (a VM) and stream (a physical box) — are built from one shared routing-common definition as an active/backup VRRP pair, and everything clients touch (gateway, DNS) is a floating VIP that follows the master.

Boxes

Box Role Host
palace VM host physical
river Primary router (VRRP pair with stream) VM on palace
stream Secondary router (VRRP pair with river) physical
cellar NVMe-oF / SPDK storage target VM on palace
sfh NixOS container host (containers on its page) VM on palace
castle Workstation / gaming desktop physical

Router VIPs

Clients use per-VLAN floating VIPs as their gateway and DNS server; keepalived moves them between river and stream. The addresses, DHCP/RA behavior and failover mechanics are documented once in Router VIPs and Router HA.

Networks

The site separates core management, high-MTU trusted traffic, general trusted traffic, untrusted clients and the two WAN paths. VLAN IDs, prefixes, MTUs and router addressing live in the canonical home section of networking.md.

Switch fabric

The boxes hang off three hand-configured switches — jim and dave (MikroTik, RouterOS) and brian (Ubiquiti, UniFi) — which are not managed by this flake. The physical topology, VLAN map, the Digiweb WAN path (trunked VLAN 10 + PVID 140 at the ONT edge), and the multi-ONT plan are documented in switches.md.

Wireless APs

The Wi-Fi APs — vibe (MikroTik cAP ax) and wave (Cudy AX3000 on OpenWrt) — are dumb APs, also not managed by this flake. The shared VLAN-trunk design, SSIDs, per-AP management addressing, and the OpenWrt flash/config for wave are in aps.md.

5G WWAN

A Quectel RM500U-EA USB modem with a GoMo SIM is being evaluated as a replacement for stream's Virgin Media WAN. It is bench-tested only and not yet referenced by the flake; the module settings it needs, the APN gotcha and the CGNAT consequences are in wwan.md.