UPS (NUT, apcupsd)
Show a UPS read through Network UPS Tools or apcupsd, including units without any display.
The UPS widget shows whether the load runs on mains or on battery, the battery charge and the runtime it leaves, the time before the automatic shutdown, the load in watts and the line voltage. It says plainly when the battery needs replacing, the UPS is overloaded or the server lost it. Many units have no screen or management interface: once a server reads them over USB, the widget shows what they never display.
Sources
| Source | Where it runs | Port |
|---|---|---|
| Network UPS Tools (NUT) | Synology, QNAP, TrueNAS, Unraid (plugin), Proxmox, any Linux, or a NUT container. Thousands of USB models through the usbhid-ups driver | 3493 |
| apcupsd | APC units, Unraid's built-in UPS settings, Linux | 3551 |
Reading is read-only: NasDash never sends a command to the UPS.
NUT on Linux
Install the nut package on the machine the UPS is plugged into, then describe the UPS, let the server listen on the network and run in network mode:
[ups]
driver = usbhid-ups
port = auto
desc = "Rack UPS"LISTEN 0.0.0.0 3493MODE=netserverRestart NUT, check that the UPS answers, and allow TCP port 3493 from NasDash's address in the firewall:
upsc upsA vendor tool that already reads the UPS over USB (for example CyberPower PowerPanel) must be stopped first: only one program can hold the USB link. If that tool shut the machine down on low battery, set the same thresholds in NUT (override.battery.charge.low, override.battery.runtime.low with ignorelb) and let NUT's upsmon shut it down.
On a NAS, enable its network UPS server and add NasDash's address to the allowed devices instead.
Connect it
- Open Settings → Integrations → UPS.
- Choose Network UPS Tools or apcupsd and enter the server address, for example
nas.example.com; leave the port empty for the default. - Save and test the connection.
NUT needs no account to read: it allows readers by address. When a NUT server watches several UPS, each widget picks one in its settings.
NasDash 0.3.6 supports several saved NUT and apcupsd connections. Give each a distinct name in Settings → Integrations, then select the connection in each UPS widget’s settings. For NUT, choose the UPS on that server separately; choosing another UPS does not create another server connection.
Automatic shutdown
When the server reports its shutdown thresholds (NUT battery.charge.low and battery.runtime.low, apcupsd MBATTCHG and MINTIMEL), the widget estimates the time before the machines are shut down at the present load: on mains, what an outage would leave; on battery, a countdown. It is an estimate: a battery drains faster near its end.
Display
Full shows the figures; Compact keeps one line. In Full, each part can be hidden: battery bar, runtime, automatic shutdown, load, line voltage and power events. Details adds the output and battery voltage, line frequency and temperature when the UPS reports them. Some units report an implausible output voltage through NUT; it is left out.
Access
Viewers need the UPS permission (Settings → Users and access). The server address never leaves the NasDash server. The public demo shows a fictional UPS.