Self-host PVE-UPS
v4.3.0Web-based UPS shutdown manager for Proxmox clusters
- Stars
- 350
- RAM
- 256 MB
- Storage
- 4 GB
- Port
- 8080 (Web UI and REST API)
- Requires
- Proxmox VE host(s)
ghcr.io/ffind-dev/pve-upsWhat is PVE-UPS?
This tool watches UPS units via SNMP using the standard RFC 1628 MIB plus vendor-specific MIBs from APC and CyberPower, or it can read data from a NUT server. When battery levels drop, it powers off Proxmox VE nodes and optionally a Proxmox Backup Server. It runs as a small LXC container (~256 MB RAM) installed by one command on the Proxmox host, or as a multi-arch Docker image. All configuration happens in a browser wizard with live test buttons — no config files to edit. Shutdown uses dedicated Proxmox API tokens that carry just the Sys.PowerMgmt privilege — no SSH access, no agents installed on the hosts. Extras include per-UPS trigger overrides, a visual shutdown-order preview, cluster-wide HA disarm and guest stop (Beta), Ceph maintenance flags (Beta), webhooks for Slack/Discord/Teams/ntfy/custom templates, a read-only REST status endpoint, historical charts with CSV export, and in-place updates from the UI. The logic is safe by default: losing UPS contact only raises an alarm, never starts a shutdown. After install the engine runs in dry-run mode so you can verify everything before arming it.
Should you self-host PVE-UPS?
PVE-UPS scores 51/100 on selfhost.directory (how scoring works) and ranks #20 of 51 in Monitoring & observability. It has 350 GitHub stars.
It shipped 10 stable releases in the past year. The latest, v4.3.0, came out on 10 October 2026. New versions land roughly every 2 weeks.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is GoAccess (75/100, 21 091 stars). It scores higher overall, so compare the two before you pick. See PVE-UPS vs GoAccess side by side.
Features
- Cluster-wide shutdown preparation (Beta)Beta feature; opt-in; needs Proxmox VE 9.2+.
- Config export/import
- Fail-safe shutdown logic
- Historical data and CSV export
- In-place updates via web UINot available in Docker deployment.
- Multilingual UI
- Multiple UPS device support
- REST status API
- Scheduled connectivity self-tests
- SNMP monitoring (RFC 1628, APC PowerNet, CyberPower)
- Web-based Configuration Wizard
- Webhook Notifications
PVE-UPS README
More in Backup Management
restic-rest-serverSelf-hosted HTTP server implementing restic's REST backend API for secure remote backups with authentication, TLS, append-only mode, and Prometheus metrics.
shieldSHIELD is an open-source, self-hosted backup and restore solution protecting PostgreSQL, MySQL, MongoDB, Redis, Consul, and etcd with encrypted cloud storage.
St0rSt0r is a self-hosted, open-source web UI enhancing UrBackup with a modern dashboard, multi-customer support, file recovery, and offsite replication — free, MIT-licensed.
unraid-duplicate-file-handlerSelf-hosted web tool for Unraid that scans drives for duplicate files by relative path, lets you choose copies to keep, then deletes or moves extras with progress.
unvr-nas-backupA self-hosted Docker container that backs up 24/7 UniFi Protect footage to network storage, turning proprietary video into standard MP4 files organized by camera and date
UrBackupUrBackup is a self-hosted, open-source client/server backup system for Windows, Linux, and macOS combining image and file backups with deduplication and a web interface.
VolumeVaultSelf-hosted Laravel app for Docker volume backups with safe restores, scheduled backups, encrypted destinations, and API automation.
VykarSelf-hosted Rust backup tool with YAML config, multiple storage backends, built-in scheduling, desktop GUI, and WebDAV for browsing snapshots.
WPMgrWPMgr is a self-hosted, open-source WordPress fleet management platform for backups, updates, uptime monitoring, image optimization, and security from one dashboard.
aeternaAeterna is a self-hosted, open-source dead man's switch that delivers messages and files if you stop checking in. Encrypts data at rest with AES-256-GCM.
alt-coreAlterante Core is a self-hosted, open-source decentralized filesystem in Java for file discovery, automated backup/replication, and web-based file access.
arkeepArkeep is an open-source, self-hosted backup management platform with a web dashboard for Restic/Rclone backups across multiple servers.
0 comments