Skip to content

docs(hardware): Pi 4 bring-up gotchas learned live + soak-check printf fix - #452

Merged
genwave-radio merged 2 commits into
mainfrom
docs/pi4-bringup-gotchas
Aug 10, 2026
Merged

docs(hardware): Pi 4 bring-up gotchas learned live + soak-check printf fix#452
genwave-radio merged 2 commits into
mainfrom
docs/pi4-bringup-gotchas

Conversation

@genwave-radio

Copy link
Copy Markdown
Collaborator

Three real catches from tonight's mjolnir bring-up, written down while warm: 🍓

  1. gh-docs(hardware): Pi kernels ship with the memory cgroup disabled — every mem_limit is silently discarded until cmdline.txt enables it #307 addendum — reboot isn't enough if the stack ever ran unfenced: restart policy resurrects containers with the discarded zero-limit baked in, and a no-diff up -d recreates nothing. The down → relaunch → inspect verify sequence is now in step 2 (piper fence must read 805306368).
  2. LAN listening: bare PUBLIC_HOST (or localhost) = Caddy auto-HTTPS with a self-signed cert = stream unreachable off-box. PUBLIC_HOST=http://<lan-name> turns it off; stream at http://<lan-name>/stream, radios tune it directly. Public boxes keep the bare-domain form.
  3. tools/soak-check.sh refill-hold line printed 6.8s6.8 (both parameter expansions emit when set) — fixed; caught on mjolnir's checkpoint zero, which otherwise PASSED: throttled=0x0 at 60.8°C with api at 207% enrichment load, boot ladder exactly 5, stream live, fences real.

…a soak-check printf fix

1) cgroup fix needs a RECREATE, not just a reboot (restart policy
resurrects unfenced containers; no-diff up -d recreates nothing).
2) LAN listening = scheme-prefixed PUBLIC_HOST (bare hostname gets
auto-HTTPS + self-signed cert = unreachable off-box).
3) soak-check's refill-hold line printed the value twice (6.8s6.8) —
expansion order fixed.
@genwave-radio
genwave-radio merged commit be996e1 into main Aug 10, 2026
11 checks passed
@genwave-radio
genwave-radio deleted the docs/pi4-bringup-gotchas branch August 10, 2026 02:18
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 10, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant