Intelligent UPS Monitoring & Shutdown Orchestration for NUT
A Python-based UPS monitoring daemon that watches UPS status via Network UPS Tools (NUT) and executes configurable shutdown sequences to protect your entire infrastructure during power events.
Most UPS shutdown solutions are single-system focused. Eneru is designed for modern infrastructure:
| Challenge | Eneru Solution |
|---|---|
| Multiple servers need coordinated shutdown | ✅ Orchestrated multi-server shutdown via SSH |
| VMs and containers need graceful stop | ✅ Libvirt VM and Docker/Podman container handling |
| Network mounts hang during power loss | ✅ Timeout-protected unmounting |
| No visibility during power events | ✅ Real-time notifications via 100+ services |
| Different systems need different commands | ✅ Per-server custom shutdown commands |
| Hypervisors need graceful VM shutdown | ✅ Pre-shutdown actions (Proxmox, ESXi, XCP-ng, libvirt) |
| Battery estimates are unreliable | ✅ Multi-vector shutdown triggers |
| Network down during outage | ✅ Non-blocking notifications with persistent retry |
- 🏠 Homelabs - Protect your self-hosted infrastructure
- 🖥️ Virtualization Hosts - Graceful VM shutdown before power loss
- 🐳 Container Hosts - Stop Docker/Podman containers safely
- 📦 NAS Systems - Coordinate shutdown of Synology, QNAP, TrueNAS
- 🏢 Small Business - Multi-server environments with single UPS
- ☁️ Hybrid Setups - Mix of physical and virtual infrastructure
PyPI:
pip install eneru[notifications]Debian/Ubuntu:
curl -fsSL https://m4r1k.github.io/Eneru/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/eneru.gpg
echo "deb [arch=all signed-by=/usr/share/keyrings/eneru.gpg] https://m4r1k.github.io/Eneru/deb stable main" | sudo tee /etc/apt/sources.list.d/eneru.list
sudo apt update && sudo apt install eneruRHEL/Fedora:
sudo dnf install -y epel-release
sudo curl -o /etc/yum.repos.d/eneru.repo https://m4r1k.github.io/Eneru/rpm/eneru.repo
sudo dnf install eneru# Edit configuration
sudo nano /etc/ups-monitor/config.yaml
# Validate and start
sudo python3 /opt/ups-monitor/eneru.py --validate-config
sudo systemctl enable --now eneru.serviceups:
name: "UPS@192.168.1.100"
triggers:
low_battery_threshold: 20
critical_runtime_threshold: 600
local_shutdown:
enabled: trueSee the full documentation for complete configuration options.
- Multi-vector shutdown triggers - Battery %, runtime, depletion rate, time on battery, FSD flag
- Orchestrated shutdown - VMs, containers, remote servers, filesystems, local system
- 100+ notification services - Discord, Slack, Telegram, ntfy, Email via Apprise
- Non-blocking notifications - Persistent retry without delaying shutdown
- Power quality monitoring - Voltage, AVR, bypass, and overload detection
- Dry-run mode - Test your configuration safely
- Comprehensive testing - Unit tests, integration tests across 7 Linux distros, and E2E tests with real NUT/SSH/Docker services on every commit
Eneru runs as a systemd daemon, not a container. This is intentional—Eneru's job is to shut down Docker/Podman containers during power events. If Eneru ran inside a container, it would be killed during its own shutdown sequence.
See the documentation for the full explanation.
Named after Eneru (エネル) from One Piece—the self-proclaimed God of Skypiea who ate the Goro Goro no Mi (Rumble-Rumble Fruit), granting him absolute control over electricity. Just as Eneru commands lightning from the sky, this tool commands your infrastructure when the power from the grid fails. Unlimited power... management! ⚡
Full documentation is available at eneru.readthedocs.io:
- Getting Started - Installation and basic setup
- Configuration - Full configuration reference
- Shutdown Triggers - How shutdown decisions are made
- Notifications - Setting up Discord, Slack, Telegram, etc.
- Remote Servers - SSH setup for NAS and other servers
- Testing - Testing strategy and coverage
- Troubleshooting - Common issues and solutions
MIT License - See LICENSE file for details.