# PVE-UPS

PVE-UPS is a web-based uninterruptible power supply (UPS) monitoring and graceful shutdown appliance for Proxmox Virtual Environment (Proxmox VE). It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/4590/pve-ups

## Description

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: Proxmox.

## Health score

55/100 (Fair), based on 5 of 5 factors.
- Maintained: 93 (last commit 18 days ago)
- Popular: 52 (380 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 15 (2 serious findings, 9 minor)

## Security check

2 serious findings: Uses anyio 4.14.0, which has a known critical vulnerability; Uses certifi 2026.6.17, which has a known critical vulnerability.
Automated checks on commit bdc1966, 2 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/ffind-dev/pve-ups
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=pve-ups

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/4590/pve-ups), the self-hosted and open-source app directory.
