jet/noisebell
jet/noisebell
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: add documentation for pi relay and home automation

Browse source
This commit is contained in:
Jet 2026-03-24 00:51:27 -07:00
parent 4f7ac0e7d7
commit 3dcd3f00d8
No known key found for this signature in database
3 changed files with 80 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

9
README.md
View file

@ -10,6 +10,8 @@ A Raspberry Pi reads a magnetic sensor on the door and pushes state changes to a
Pi (door sensor) ──webhook──> Cache ──webhook──> Discord / Zulip
|
polls Pi <-+
|
+──webhook──> Pi relay ──webhook──> Home Assistant
```
## Layout
@ -23,3 +25,10 @@ Pi (door sensor) ──webhook──> Cache ──webhook──> Discord / Zulip
Each directory has its own README with setup and configuration details.
For hosted deployment, another repo such as `../extremist-software` imports `noisebell.nixosModules.default`. That host repo provides deployment-specific values like domains, ports, and the Pi address, while the Noisebell module itself points `agenix` at the encrypted files in `secrets/` and consumes the decrypted runtime files on the target machine.
Useful commands:
- `./scripts/nhs` redeploys the remote cache host using the local checkout as the flake input
- `scripts/deploy-pios-pi.sh pi@100.66.45.36` redeploys the Raspberry Pi OS machine
The full Home Assistant relay workflow is documented in `pi/README.md`.