Repository navigation
v0.1.0
Pre-release
Pre-release
First release of nutwake: a NUT-aware shutdown helper, Wake-on-LAN and a read-only status page, in one small static Go binary.
This is a pre-release. It has been tested against a fake UPS and fake nodes, including a whole power cut from the first loss of mains to the wake packets. It has not yet been run on a real UPS, real nodes or a real Raspberry Pi. The systemd unit, ping with its capability, and Wake-on-LAN on real network cards are the parts those tests cannot cover. Run nutwake check, then do the plug-pull test described in the README, before you trust it with real machines.
What it does
- Shuts the nodes down cleanly when the power goes out, and the Pi waits until they are really off before it halts itself.
- When power returns, wakes only the nodes the power cut shut down, and only once power has been steady and the battery has recharged to the level you set (15% by default).
- Serves a read-only status page that shows what happened minute by minute, including the stretch when the Pi itself was off.
nutwake demoruns the status page on made-up data, so you can try it without a UPS.
Downloads
Static binaries for Linux, with no dependencies:
nutwake-linux-arm64: a 64-bit Raspberry Pinutwake-linux-armv7: a 32-bit Raspberry Pi OSnutwake-linux-amd64: x86-64SHA256SUMS: checksums for the three binaries. Check them withsha256sum -c SHA256SUMS.
The README has the full install steps for the binary, the systemd unit, the NUT setup and Wake-on-LAN.
Things to know
- The status page has no login and cannot change any settings. Keep it on your LAN.
- Configuration is read when the service starts. Restart it after a change.
- Prefer a
tcp:<port>probe, or havepinginstalled (iputils-ping) for theicmpprobe.