I ran across this project today on Reddit and then looked at the project on GitHub. and thought it was worth sharing with everyone.
Here is the GitHub: https://github.com/ffind-dev/pve-ups
If you've ever configured NUT, you know it is super powerful, but it is also known to not be for the faint of heart. It can be more complicated than what many home lab users actually need. This project takes a different approach by focusing on a graceful Proxmox shutdown during a power outage. The author was transparent that he vibe coded the tool. But honestly, it looks really amazing.
From what I've read, it runs as a lightweight Debian LXC and provides a web-based wizard to set things up instead of making you edit NUT configuration files. It communicates with Proxmox using the API. I like this as it means you don't have to install agents on each node or rely on SSH for shutdown operations.
A few features that stood out:
- Web UI for configuration
- Uses Proxmox API tokens with few permissions actually needed
- Gracefully shuts down VMs and LXCs before powering off the hosts
- Keeps the host running the appliance online until the rest of the cluster has shut down
- Very lightweight resources are needed.
One important limitation is that it currently supports UPS units with an SNMP management card only. If you're using a USB-connected UPS, NUT is still the recommended solution for that configuration..
I haven't had a chance to test this in my own lab yet, but I really like seeing projects that simplify common Proxmox management tasks. For those of us already running network-managed APC, CyberPower, or Eaton UPS units, this looks like it could be a nice alternative.
Has anyone here already tried this or looking at deploying it? If so, I'd be interested to hear:
- Which UPS are you using?
- How was the setup process?
- How has it behaved during actual power events?
Looking forward to hearing everyone's experiences.
