PVE-UPS

PVE-UPS is a web-based uninterruptible power supply (UPS) monitoring and graceful shutdown appliance for Proxmox Virtual Environment (Proxmox VE).

  • Infrastructure
  • Monitoring & Logging
  • Tools & Utilities
PVE-UPS is a web-based uninterruptible power supply (UPS) monitoring and graceful shutdown appliance for Proxmox Virtual Environment (Proxmox VE). It watches one or more UPS devices over Simple Network Management Protocol (SNMP) or a Network UPS Tools (NUT) server, then orders Proxmox hosts and Proxmox Backup Server to shut down cleanly during a power outage. It is aimed at homelab and small-datacenter Proxmox admins who want a wizard-driven, API-monitorable replacement for vendor UPS shutdown appliances.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

55/100 Fair

Maintained
93last commit 18 days ago
Popular
52380 GitHub stars
Easy to install
251 install platform, install notes
Light to run
502 GB minimum RAM
Security check
152 serious findings, 9 minor

Availability: platform listings confirmed today

GitHub stars
380
Open issues
8
Last commit
2026-11-03
Latest release
v4.4.0
License
MIT
Activity
declining

Checked 4 days ago - source: GitHub (ffind-dev/pve-ups)

Resources & Compatibility

Minimum requirements: 2 GB RAM.

Checked 40 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the Proxmox driver in Rancher Add the pve-node-driver Helm repo (a package source for Rancher's app installer) and run the README install steps to load the Proxmox node driver and Rancher UI extension. Without these, Rancher can't manage Proxmox virtual machines from its dashboard. source
  • Use local URLs for an air-gapped Rancher If your Rancher server is air-gapped (cannot reach the internet), set nodeDriver.url and uiPlugin.endpoint to local file URLs. That lets Rancher fetch the driver and UI extension from your own server instead of failing. source
  • Configure after installation Use the PVE-UPS web wizard to add the UPS device and choose the Proxmox hosts or Proxmox Backup Server that should shut down during a power outage. source

Fetched 40 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How can I connect USB or serial UPSes to PVE-UPS?

Run an existing NUT server and point PVE-UPS at it as a read-only client, so USB and serial UPS devices are read through NUT.

What Proxmox token permissions should I grant to PVE-UPS?

Use a dedicated, revocable Proxmox API token with only the Sys.PowerMgmt privilege for shutdowns.

How should I expose the PVE-UPS web interface and monitoring endpoints?

Keep it on a trusted internal management network with the same firewalling and access control as the Proxmox web interfaces. The status and health endpoints are intentionally readable without login so monitoring can poll them.

Which SNMP MIB does PVE-UPS use for network UPS cards?

It uses the standard RFC 1628 UPS MIB via SNMP v1/v2c/v3 and can automatically switch to a vendor MIB, such as APC PowerNet, where the standard MIB is not enough.

Can PVE-UPS also shut down Proxmox Backup Server?

Yes, in addition to Proxmox VE hosts, it can shut down a Proxmox Backup Server if configured.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads