boma/docs/hardware/reference.md

Hardware reference — boma

Hand-maintained source of truth for physical compute + network gear and workload placement intent. The two machine-readable tables (Node capacity, Workload placement) are parsed by scripts/capacity-scan.py — keep their headers intact. Evaluated by /capacity-review. See ADR-012.

Status: skeleton. Replace example rows with real hardware once the cluster is stood up (STATUS.md tracks real-vs-planned).

1. Physical compute

pve0

• Model / form factor: TBD (e.g. Minisforum MS-01, mini-PC)
• CPU: TBD (e.g. i9-13900H, 14C/20T)
• RAM: _TBD total; max _; free DIMM slots _
• Storage: TBD (disks → pools, e.g. 2× 2 TB NVMe → local-zfs)
• NICs: eno1 trunk (vmbr0), eno2 corosync (vmbr1)
• Notes: warranty, quirks

(repeat for pve1, pve2, askari)

2. Network gear

device	model	ports	poe	throughput	uplinks	notes
opnsense	TBD	TBD	n/a	TBD	WAN+LAN	dedicated hardware
switch	TBD	TBD	TBD	TBD	trunk	managed, 802.1q
ap1	TBD	TBD	TBD	TBD	trunk	multi-SSID per VLAN

3. Workload placement & intent

The numeric columns (cores, ram_mb, disk_gb) feed capacity-scan.py; the free-text columns feed /capacity-review's judgement.

workload	node	cores	ram_mb	disk_gb	criticality	ha_intent	profile	constraints	growth
dns1	pve0	1	512	10	high	pair/dns2	tiny/steady	anti-affinity: dns2 on a different node	flat
dns2	pve1	1	512	10	high	pair/dns1	tiny/steady	anti-affinity: dns1 on a different node	flat

4. Node capacity (machine-readable)

Physical totals per node. Integers; ram_gb and disk_gb may be decimals.

node	cores	ram_gb	disk_gb
pve0	20	64	4000
pve1	20	64	4000

5. Capacity notes

Free-text running notes for the evaluator (trends, planned moves, upgrade ideas).