Network UPS Tools (NUT)
The Network UPS Tools (NUT) integration allows you to monitor and manage a UPS (battery backup) using a NUT
Configuration
To add the Network UPS Tools (NUT) device to your Home Assistant instance, use this My button:
Network UPS Tools (NUT) can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
Manual configuration steps
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Network UPS Tools (NUT).
-
Follow the instructions on screen to complete the setup.
Example Resources
Given the following example output from NUT (your variables may differ):
Use the values from the left hand column. Support is included for most
values with ups
, battery
, input
and output
prefixes.
UPS Status - human-readable version
An additional virtual sensor type ups.status.display
is available
translating the UPS status value retrieved from ups.status
into a
human-readable version.
Device Actions
A device action is available for each parameterless NUT commandupscmd -l
command followed by the UPS name:
These commands will be available as device actions in Home Assistant, allowing you to interact with your UPS.
User Credentials and Permissions
To execute device actions through the NUT integration, you must specify user credentials in the configuration. These credentials are stored in the upsd.users
file, part of the NUT server configuration. This file defines the usernames, passwords, and permissions for users accessing the UPS devices.
No actions will be available if no user credentials are specified for a given device.
Ensure the user you specify has the required permissions to execute the desired commands. Here’s an example of a user with command permissions in the upsd.users
file:
In this example, the user my_user
has permission to execute all commands (instcmds = ALL
).
Please note that Home Assistant cannot determine whether a user can access a specific action without executing it. If you attempt to perform an action for which the user does not have permission, an exception will be thrown at runtime.