BigFred OS

Documentation for BigFred OS — the reference operating-system image for a Raspberry Pi 5 layout hub. The image is built from the bigfred-os repository (Buildroot external tree) and is designed for offline club LANs: no Internet access at runtime on the hub itself.

Overview and boot init

Target hardware, read-only root with persistent /data, offline operation, BusyBox init and S* boot scripts.

Hardware §8 Hub OS image

Design goals, PREEMPT_RT, CPU isolation, storage sizing, and verification checklist.

BigFred architecture §7b Offline assets

SPA assets bundled at build time (applies to bigfred-os-ui on the hub).

Source repository

Path	Role
`bigfred-os/os/`	Buildroot `BR2_EXTERNAL` — kernel, defconfig, overlays
`bigfred-os/os/overlays/`	`fstab`, `inittab`, `init.d/S*`, Redis/Grafana configs
`bigfred-os/apps/`	Hub Go binaries (`bigfred-os-ui`, `fanctl`, …)

Build artefact: os/output/images/hub-nvme.img (symlink sdcard.img).