WOLNUT is a lightweight Python service designed to work alongside NUT (Network UPS Tools) to automatically send Wake-on-LAN (WOL) packets to client systems after a power outage.
wolnut... get it?
When a UPS (connected to NUT) switches to battery power, WOLNUT:
- Detects the power event via
upsc - Tracks which clients were online before the outage
- Waits for power to be restored and the battery to reach a safe threshold
- Sends WOL packets to bring back any systems that powered down
This helps reboot systems automatically after a controlled shutdown caused by a power loss — especially useful for homelabs, small servers, and media boxes.
- Auto-detect MAC addresses with ARP
- Tracks online status of clients via ping
- Supports NUT with or without authentication
- Persistent state file for post-reboot recovery
- Runs as a standalone Python service or Docker container
See the Quickstart guide.
See docker-compose.yml for an example docker compose file