pi-swarm/README.md

planck — 20-node Raspberry Pi 4 home lab

20× Raspberry Pi 4 Model B (8GB), each booting a 240GB USB SSD. Named planck001–planck020. Network: Ubiquiti UDM Pro, 2 switches, one router. Synology NAS on the same LAN for shared storage.

Docs

• docs/INVENTORY.md — hardware inventory (regenerate: ./scripts/inventory.sh > docs/INVENTORY.md)
• docs/MACS.txt — eth0 MAC addresses (for DHCP reservations)
• docs/PLAN.md — the rebuild plan and decisions log

Scripts

• scripts/inventory.sh — collects hardware/network inventory from all nodes

Node access

SSH: ssh adamcarr@planck0NN.local (key auth set up 2026-09-19). mDNS resolves planck0NN.local across subnets.