Files
nixfiles/docs/sites/home/sfh/containers/unifi.md
T
jackos1998 a04d11423a nixos/home: Separate router storage and uplinks
Give `river` a dedicated RDMA VF and two RSTP trunk attachments.
Keep client services on the router VIPs and carry Digiweb VLANs
over both switch paths.

Set VF trust, multicast reception, bridge MAC and ARP behavior for
local switching. Wait for Kea interface readiness and apply RSTP
costs through `mstpd` despite port-registration and rename races.

Load `palace`'s RAID module in the initrd. Record RouterOS and
RouterBOOT upgrades and validate port, carrier and switch outages.

Document the deployed architecture, interface handoffs and recovery
procedures. Add physical socket maps, NIC capacities and cable
connections alongside the logical topology and failover checks.
2026-11-15 16:23:06 +00:00

2.0 KiB

unifi

The UniFi network controller, running as a container on sfh. It manages the home UniFi switch brian (see switches.md).

Role

  • UniFi controller (services.unifi, pkgs.unifi on mongodb-7_0, firewall open; TCP 8443 allowed).
  • Not a deploy-rs target (my.deploy.enable = false) — it's rendered via my.asContainer and started by sfh's my.containers.instances.

Network assignments

See the consolidated network assignments table (this box: unifi).

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

Networking

Two MACVLAN interfaces come from sfh's container NICs: host0 on ctrs-hi carries the hi assignment (unifi-ctr, default gateway via the VIP), while lan-core on ctrs-core carries the gatewayless core assignment (unifi-ctr-core). The core interface is how the controller talks to brian and the other switches on their management network.

Notable config files