# Homelab infrastructure notes

The wiring diagram `diagrams/topology.svg` — titled "Homelab network
topology" — is the current-state reference for the rack layout. When a
question is about the homelab network topology, that diagram is the
picture to open: it shows the edge router uplinking two managed
switches, the hypervisor rack and the nas storage shelf.

Uplink rules, restated in prose so the words are searchable next to the
diagram: the edge router hands one 10Gb link to rack-1 switch and one
to the second switch; the hypervisor VLANs live on rack-1 switch, and
nas storage sits behind the second switch on its own segment. The
diagram carries no other labels — anything else about the network
belongs in this note, not in the drawing.