VR1 Office1 -- as-built inventory and connection reference

Purpose. The single operational answer to "what is running, where, on what address, and how do I reach it." Every value here was MEASURED on the live system, not planned or inferred. Update it in the SAME change that brings a host or service online -- a stale connection table is worse than none.

Scope. VR1 Office1 only (the site headend). DC1/DC2 get their own sections when they exist.

Authority note. NetBox is the IPAM apex -- this table is an OPERATIONAL reference (how to reach things, where credentials live), NOT the address authority. Where the two ever disagree, NetBox wins and the divergence gets fixed here. The D-115 carve is not yet imported into NetBox (open item).

Last measured: 2026-07-13.

1. Networks

The DHCP split is structural. Two authorities, two physically separate L2s. lxdbr0 is NEVER bridged onto office1-local, so Kea and MAAS cannot see each other. LXD's own dnsmasq is disabled (ipv4.dhcp=false, dns.mode=none, raw.dnsmasq=port=0) and binds no :53 and no :67.

IPv6: Office1's carve is 2602:f3e2:f01:100::/56 with office subnet 2602:f3e2:f01:100::/64 (D-115). NOT YET DEPLOYED -- pinned as the next step. Note IPv6 does NOT egress the lab (measured: v6 gateway reachable, v6 internet 100% loss), so v6 here will be LAN-local only.

2. Hosts and services

office1-netbox and office1-tailscale are MAAS-composed LXD VMs (D-114) -- MAAS enlisted, commissioned, deployed and powers them. The voffice1 LXD host is office1-lxd (vm-host id 1).

3. How to reach each thing

All access is via the Office1 service SSH key: ~/vr1-office1-creds/office1_svc_ed25519 on vcloud (private half NEVER read; SEC-007 tracks its rotation).

office1-local (10.10.0.0/24) and lxdbr0 (10.10.1.0/24) are host-local to vcloud -- not routable from a workstation. Everything below therefore tunnels through vcloud.

Routing to the compose net. The OPNsense edge has a static route 10.10.1.0/24 -> 10.10.0.20 (gateway object OFFICE1_LXD_GW, priority 255, NOT the default gateway). So any office1-local client using the edge as its gateway reaches the compose net. vcloud itself does NOT -- its default route is the lab, so it needs an explicit route (operator sudo): sudo ip route replace 10.10.1.0/24 via 10.10.0.20 dev virbr2

Tailscale (once authorized + the route approved in the admin console) makes 10.10.0.0/22 reachable from the tailnet directly -- i.e. the whole Office1 carve, edge GUI and MAAS UI included, with no tunnels. That is the intended "front door" (D-107: Office1 ONLY).

4. Where the credentials live (NEVER commit; never print)

NetBox API token format (4.6): the wire form is nbt_<key>.<plaintext>. The API's token field alone is NOT usable -- present it raw and you get 403 Invalid v1 token. See docs/changelog-20260713-office1-netbox-deployed.md.

5. Standing traps for this site (the short list)

1. DHCP on the edge is API-MANAGED. A rendered config.xml push would CLOBBER it. That path is DELETED (D-113(a2)); configure via scripts/opnsense-api.sh.
2. OPNsense gateways: defaultgw in the API output is DERIVED FROM priority (lower = more preferred), not from what you send. Adding a LAN gateway with a lower priority than WAN_GW SILENTLY STEALS THE DEFAULT ROUTE and kills site egress -- this happened on 2026-07-13. Always add the gateway, READ THE CONFIG BACK, confirm WAN_GW is still default, and only THEN reconfigure. WAN_GW is now priority 1; OFFICE1_LXD_GW is 255.
3. root's shell on the edge is tcsh -- $(...) and 2>&1 fail (quietly, or with "Ambiguous output redirect"). Feed remote commands to sh -s.
4. lxc reads config from stdin -- in a piped script every lxc call needs </dev/null or it eats the rest of the script.
5. MAAS's bind9 intermittently SERVFAILs a first-time external lookup and succeeds on retry (seen twice: docker registry, tailscale.com). Retry before diagnosing.
6. A tofu apply touching a libvirt_domain's devices BOUNCES THE GUEST, even when the plan says "updated in-place". Schedule it as an outage.