Add a top-level README mapping the boxes and a full docs/ tree: topic pages (architecture, networking, deployment), per-site box pages for colony and home with containers nested under their hosts, remote and mobile boxes, the installer, and the home switch fabric reference (folded in from home-switches.md, with AGENTS.md and code comments retargeted to its new home). Box pages carry marked assignment tables that CI regenerates from nixos.allAssignments. AGENTS.md points at the new docs and keeps its terse agent version of the mechanics, referring to the topic pages for depth.
2.2 KiB
unifi
The UniFi network controller, running as a container on sfh. It manages the
home UniFi switch brian (see switches.md).
- Source:
nixos/boxes/home/palace/vms/sfh/containers/unifi.nix - Host: NixOS container on
sfh
Status
Currently enabled. The container spent a while disabled — its import was commented out of
containers/default.nix
while there was no UniFi gear to manage — and was re-enabled when the UniFi switch brian was
added, gaining a core leg (unifi-ctr-core) at the same time so it can reach the switch on its
management network. It is imported, listed in sfh's my.containers.instances, and
services.unifi.enable = true.
Role
- UniFi controller (
services.unifi,pkgs.unifionmongodb-7_0, firewall open; TCP 8443 allowed). - Not a deploy-rs target (
my.deploy.enable = false) — it's rendered viamy.asContainerand started bysfh'smy.containers.instances.
Network assignments
| Name | Assignment | IPv4 | IPv6 | Domain | Notes |
|---|---|---|---|---|---|
| unifi-ctr-core | core | 192.168.64.21/24 |
— | h.nul.ie | |
| unifi-ctr | hi | 192.168.68.100/22 gw 192.168.71.254 |
2a0e:97c0:4d0:1::5:1/64 |
h.nul.ie |
Networking
Two MACVLAN legs from sfh's container NICs: host0 on lan-hi-ctrs (the hi assignment —
unifi-ctr, 192.168.68.100, default gateway via the VIP) and lan-core on lan-core-ctrs
(the core assignment — unifi-ctr-core, 192.168.64.21/24, no gateway). The core leg is
how the controller talks to the switches: brian lives at 192.168.64.13 on core.
Notable config files
nixos/boxes/home/palace/vms/sfh/containers/unifi.nix— container system: UniFi service, assignments.nixos/boxes/home/palace/vms/sfh/default.nix— thesfhside: container instance, MACVLAN wiring.