Add-on request: Network UPS Tool (NUT)

Apologies in advance if this belongs in the “Feature Request” section. Wasn’t sure if I should post it there or here in

I recently purchased a CyberPower UPS to plugin all of my networking and Raspberry Pi devices, one of which runs There’s a piece of software called Network UPS Tool (NUT) that can monitor the status of most UPS systems. I currently have it running on a separate Raspberry Pi with the Home Assistant NUT component so I can view my UPS status. I’d like to eventually further expand this such that if my home loses power and the battery gets to a certain state, to gracefully shutdown my Raspberry Pi’s.

Anyways, I think it would be awesome to be able to have this as a add-on for folks to easily add the NUT services required to utilize the NUT component in Home Assistant.

Interestingly, there is this.

1 Like

Can’t believe I missed that… thanks!

I noticed it doesn’t show up in the Add-on Store but it’s in the official community add-on repo.

I think you’d have to add the experimental repo to have it show up for install:

Just keep in mind that there may be issues with it or other add-ons due to enabling it.

1 Like

!!! Problem Solved !!!
The addon is working again after i did a power cycle of the UPS.

Am still having issues with this NUT Addon. Any ideas?

Also tried these addons without any luck.

[cont-init.d] exited 0.
[cont-init.d] executing…
Log level is set to INFO
[cont-init.d] exited 0.
[cont-init.d] executing…
[11:28:53] INFO: Copying user config files
[cont-init.d] exited 0.
[cont-init.d] executing…
[11:28:53] INFO: Generating /etc/nut/upsd.users…
[11:28:54] INFO: Configuring user: nut
[11:28:55] INFO: Password is NOT in the Have I Been Pwned database! Nice!
[cont-init.d] exited 0.
[cont-init.d] executing…
[11:28:56] INFO: Starting the UPS drivers
Network UPS Tools - UPS driver controller 3.8.0-3396-gcdc7c4b5b1
Network UPS Tools - Generic HID driver 0.41 (3.8.0-3396-gcdc7c4b5b1)
USB communication driver 0.33
No matching HID UPS found
Driver failed to start (exit status=1)
[cont-init.d] exited 1.
[cont-finish.d] executing container finish scripts…
[cont-finish.d] executing…

            Oops! Something went wrong.

We are so sorry, but something went terribly wrong when
starting or running this add-on.

Be sure to check the log above, line by line, for hints.

[cont-finish.d] exited 0.
[cont-finish.d] done.
[s6-finish] waiting for services.
[s6-finish] sending all processes the TERM signal.

!!! Problem Solved !!!
The addon is working again after i did a power cycle of the UPS.

Is there any information available on getting this running on a NUC running Ubuntu/Docker/Hassio

Hi @GaryK try this bad boy

Thanks, but a bit over my head :grimacing:

Have you got a running container for this image?

If so, could you post up a good docker-compose.yaml and configuration files?

I’ve been banging my head against a wall trying to get this running. I’m was making progress and it’s been frustratingly slow but I think I’ve hit a wall. Google hasn’t offered any additional solutions, either.

Any help would be appreciated.

wont run for me, complained abount secrets, so i figured that out, and now complaining about not being able to create a ups.conf file

Is there a repository which contains this add on? The repository linked in that page does not have it anymore

edit: I found it! It’s in the experimental repository

sorry for briging an old thread.
I’m not sure I understand how it works, do I own a
the network input output doesn’t seem to be for communication, only the serial and usb, I need to connect the usb directly in my raspberry pie?

You need to connect the UPS via USB to whatever is running your NUT server. I was never able to get the HA add-on to work, so I setup the NUT server on a separate raspberry pi that I have running PiHole. From there, I just run the NUT integration from HA (not to be confused with the NUT add-on which is the server) which acts as a client and connects to the NUT server.

Hello @menekis @shred,

i have some trouble too and i am on Hassio / HassOS,

i solved the problem by just expose the port 3493 in HAssio AddOn :

port 3493

Here is my config YAML:

  - platform: nut
    name: CP1500
    host: 192.168.1.xx
    port: 3493
    alias: CP1500
    username: xxxxxxxxxxxx
    password: xxxxxxxxxxxxxxxxxx
      - ups.status.display
      - ups.load
      - ups.realpower.nominal
      - input.voltage
      - battery.charge
      - battery.runtime    

Here is my config of the AddOn :

  - username: xxxxxxxxxxxxxxx
    password: xxxxxxxxxxxxxxxxxxxxx
      - all
    actions: []
  - name: CP1500
    driver: usbhid-ups
    port: auto
    config: []
mode: netserver
shutdown_host: 'false'
list_usb_devices: 'true'

Hope it can help others!



Thank you so much - this helped me as well

1 Like

Does anyone know where I can find the list of supported monitored conditions?

I set up the sensor but I only get 4 sensors (charge status, runtime, battery voltage & input voltage) even tho the add-on lists a lot more than that and I’ve selected a bunch of those.

I don’t know if I’m doing something wrong or if those are the only available things to monitor.

I’ve got a Cyberpower CP1500AVRLCDa UPS.


here you have the list of available variables for your CP1500 in NUT integration of HA :


you have to add them under “ressources:” take a look of my config POST #14

1 Like

Thanks for that info.

looks like it was me. I had some things selected that weren’t available and other options that I didn’t select that were similar.

yes, some variable are unavailable now in HA, dont know why…

Thats happened with 0.107 or 0.108…another “breaking change” lol

Could you possibly just clarify the steps for me to access a UPS Network Management Card 2 (9630) on a Smart-UPS SMX1500 using NUTS? Trying to get my head around the whole process as I’m new to this. I’m using Hassio and from what I understand, this is the process.

  1. Install NUT add-on which acts as a NUT server and connects to the remote UPS (can’t get the server to run for some reason).
  2. Install NUT integration and connect to NUT add-on (server).

Are there any steps I need to take onboard the UPS itself for access and what is the advantage of going this route vs just setting up SNMP sensors like this thread?