UPS (NUT)
homebridge-ups · v1.3.11
Adds UPS devices from Network UPS Tools with battery and power status plus alarm control.
What it says it supports
Brands
- Network UPS Tools
Devices it names
- NUT-connected UPS devices
Shows up in Apple Home as from its README
What people report
Works with UPS units via NUT; available values depend on what each UPS reports, and newer APC units report little.
- Partly works2
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| APC SMT2200 UPS | Partly works | Works but reports no consumption; newer APC UPS expose few variablesSaved copyHere's the dump of `ups info`: It doen't look like your UPS reports consumption, nor anything that can be used to compute this. My UPS reports `ups.realpower.nominal` (nominal power in W) and `ups.load` (percentage of nominal power provided), which Homebridge UPS uses to compute consumption. I've also seen UPSs that report `output.current` (in A) and `output.voltage` (in V), which Homebridge UPS can use alternatively. [9/7/2024, 5:16:01 PM] [Mech Room Rack UPS] Mech Room Rack UPS Battery: Voltage: set to 30V [max] Hm, you have a (nominal) 48V battery, which actually runs at 53.1V. I need to … Excerpt saved from GitHub on 2026-10-22. | Issue #24 · 2024-09 |
| Eaton 3S 850 UPS | Partly works | Voltage and consumption showed null; fixed parsing in beta, battery voltage stays 0Saved copyEaton 3s 850: set Voltage to nullV Homebridge UPS reads the mains voltage from `input.voltage`, which your UPS doesn't report. I suppose I could use `output.voltage` instead, or simply not expose _Voltage_. Eaton 3S 850 Battery: set Voltage from nullV to nullV Homebridge UPS reads the battery voltage from `battery.voltage`, which your UPS doesn't report. I'm afraid the only solution here, is not to expose the battery _Voltage_. set Current Consumption to nullW Homebridge UPS computes the consumption from `ups.load` (which indicates the load as percentage) and `ups.realpower.nominal`, which … Excerpt saved from GitHub on 2026-10-22. | Issue #5 · 2022-10 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
NUT upsd socket on port 3493
You’ll need
- Network UPS Tools (upsd)
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^2.4.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^24||^22 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | UPS |
| License | Apache-2.0 |
Community signals
| Downloads a week | 101 |
|---|---|
| Downloads a month | 312 |
| GitHub stars | 29 |
| Open issues | 0 |
| Closed issues | 29 |
| Last code push | 2026-08-29 |
| Latest version | 1.3.11 (2026-08-29) |
| First published | 2022-09-18 |
| Releases | 54 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Eve history for power
Sources
- npm: https://www.npmjs.com/package/homebridge-ups
- Source code: https://github.com/ebaauw/homebridge-ups
- Issues: https://github.com/ebaauw/homebridge-ups/issues
- Verified plugins list: https://github.com/homebridge/verified