Skip to content

v0.1.0

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 19 Nov 02:50
63253ee

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 demo runs 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 Pi
  • nutwake-linux-armv7: a 32-bit Raspberry Pi OS
  • nutwake-linux-amd64: x86-64
  • SHA256SUMS: checksums for the three binaries. Check them with sha256sum -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 have ping installed (iputils-ping) for the icmp probe.