Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Plugin] NUT v2 - Network UPS Tools

Featured Replies

On 2/4/2025 at 6:09 PM, misterwiggles said:

@RyszI’ve searched around a bit but only found one similar posted question that was never answered. Does the plug-in allow for UPS event triggers to run an external script? I have it all running as a Netserver and slave for two Unraid servers, but I also need to run a script to gracefully shutdown a Ubiquiti UDM Pro router and my understanding is that I have to use a script to do that until Ubiquiti builds NUT into their software (if they ever do). Anyone else with a similar issue that can comment on how they solved this? Need both the method for executing a script and preferable another UDM Pro user that has a script that works. Thank you!

 

You can use the event hooks script with the NUT Configuration Editor in GUI:

grafik.thumb.png.312362a32423bc9b69e38811db58f68b.png

  • Replies 2.1k
  • Views 457.5k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • I am stopping updates for my version of the plugin. Update to the latest version 2023.09.17 and then you can remove my version and install Rysz's from CA and it will retain your configs.   T

  • Released 2023.07.26, @ich777 is creating a new package for me to use, and I want to look to move to 2.8 as the default version but will need to check upgrade path works ok.

  • That APC BX series is known to suffer from this (what we believe to be) firmware issue and we've put patches in place to suppress this unwanted behaviour on the UPS side. Here's how you can set it up:

Posted Images

Thanks @Rysz Is there documentation for this somewhere?

 

On 2/5/2025 at 10:29 PM, Rysz said:

 

You can use the event hooks script with the NUT Configuration Editor in GUI:

grafik.thumb.png.312362a32423bc9b69e38811db58f68b.png

 

Someone know why I cant connect to the NUT-Server via OPNsense?

 

image.thumb.png.039c7492a8c7ca8e0ee07fe2b2b811b9.png

image.thumb.png.6c95bd96f7cee1031574cce64c779655.png

Edited by PlanetDyna

On 2/12/2025 at 5:56 PM, PlanetDyna said:

Someone know why I cant connect to the NUT-Server via OPNsense?

 

image.thumb.png.039c7492a8c7ca8e0ee07fe2b2b811b9.png

image.thumb.png.6c95bd96f7cee1031574cce64c779655.png

your username should be felix, its the NUT Slave Username.

Thank you. But also this isnt working. :(

53 minutes ago, PlanetDyna said:

Thank you. But also this isnt working. :(

in unraid nut settings rest your config set it to server and only change the password. and in opnsense set nut to client in both tabs and point it to unraid IP

 

Screenshot 2025-02-16 at 8.15.56 PM.png

Screenshot 2025-02-16 at 8.19.00 PM.png

Screenshot 2025-02-16 at 8.19.28 PM.png

how do I run multiple UPSs on my unraid? I cant seem to find where to add another one

Hi Guys

I have just bought a Energenie EG-UPS-033.

I have try every drivers but I always get this error message in log

Quote

Feb 19 22:36:25 Tower rc.nut: Writing NUT configuration... Feb 19 22:36:27 Tower rc.nut: Updating permissions for NUT... Feb 19 22:36:27 Tower rc.nut: Checking if the NUT Runtime Statistics Module should be enabled... Feb 19 22:36:27 Tower rc.nut: Disabling the NUT Runtime Statistics Module... Feb 19 22:36:28 Tower rc.nut: Network UPS Tools - Generic HID driver 0.53 (2.8.2) Feb 19 22:36:28 Tower rc.nut: USB communication driver (libusb 1.0) 0.47 Feb 19 22:36:28 Tower rc.nut: libusb1: Could not open any HID devices: insufficient permissions on everything Feb 19 22:36:28 Tower rc.nut: No matching HID UPS found Feb 19 22:36:28 Tower rc.nut: Driver failed to start (exit status=1) Feb 19 22:36:28 Tower rc.nut: Network UPS Tools - UPS driver controller 2.8.2

 

Is there any way that i can put the nut plugin working ?

 

If anyone is looking to get NUT running with MacOS, there is a great app called "UPS Power Monitor" (€8.99) which you install on one Mac in your network, then you install a separate helper "server" agent on each Mac (free / open source).

 

See here Power Guard

 

The app connects to your unRaid NUT server instance, then can shutdown your Macs depending on battery remaining, time on battery or battery percentage.

 

Very handy little app. I only looked into all of this because I had an iMac power supply blow due to a power failure recently, all wired machines are now on some form of UPS, with the main one that was already on the unRaid machine doing the heavy lifting.

Edited by CasaP

After the last update (2025.02.26) ups.load is displayed as 0, although it is not. Before it worked correctly

On 2/18/2025 at 3:34 AM, phlexall said:

how do I run multiple UPSs on my unraid? I cant seem to find where to add another one

 

It's not possible to display multiple UPS in the GUI at the moment.

 

On 2/19/2025 at 11:37 PM, Server_home said:

Hi Guys

I have just bought a Energenie EG-UPS-033.

I have try every drivers but I always get this error message in log

 

Is there any way that i can put the nut plugin working ?

 

 

It doesn't look like NUT supports your UPS from this mailing list conversation (although a bit dated):
https://alioth-lists.debian.net/pipermail/nut-upsuser/2017-March/010555.html

 

39 minutes ago, va1entin said:

After the last update (2025.02.26) ups.load is displayed as 0, although it is not. Before it worked correctly

 

No functional changes were made to the NUT package, please try to restart NUT (or another USB port).

3 hours ago, Rysz said:

No functional changes were made to the NUT package, please try to restart NUT (or another USB port).

Of course you are right. I made a ridiculous mistake, the plugin works perfectly. Thanks!

I would, however, need some advice. I need that when the plugin shutdowns the server, an mqtt command to be executed before. The solution I found so far was to copy the nut-notify script to /boot/config, modify it as I want, and every time the server is restarted, it is copied back to the /usr/sbin/ folder. Is there a more elegant solution to this problem?

Thanks!

Edited by va1entin

5 minutes ago, va1entin said:

Of course you are right. I made a ridiculous mistake, the plugin works perfectly. Thanks!

I would, however, need some advice. I need that when the plugin shutdowns the server, an mqtt command to be executed before. The solution I found so far was to copy the nut-notify script to /boot/config, modify it as I want, and every time the server is restarted, it is copied back to the /usr/sbin/ folder. Is there a more elegant solution to this problem?

Thanks!

 

Yes, you can use this script in the NUT Configuration Editor in GUI:

grafik.thumb.png.e598f9f1879e73ed8bdef5a45259e72d.png

Put the commands you need inside the respective functions, in your case ONBATT_SHUTDOWN.

Make sure to edit the script from within the GUI so that the changes are also saved after a reboot.

 

On 2/12/2025 at 6:56 AM, PlanetDyna said:

Someone know why I cant connect to the NUT-Server via OPNsense?

 

image.thumb.png.039c7492a8c7ca8e0ee07fe2b2b811b9.png

image.thumb.png.6c95bd96f7cee1031574cce64c779655.png

I'm using the NUT Master Username and password and works fine for me.

 

When heading to Diagnostics, it took a few seconds to show up. Also check your Unraid syslog too, it tells you if theres a successful authentication

 

Followed: https://docs.opnsense.org/manual/how-tos/nut.html

Been using NUT with usbhid-ups driver for a while and everything seems to be working great expect not getting the UPS Load info. Ive tired enabling a Modbus on my APC SMC1500I-2UC and tried using the Modbus driver though it didn't work at all . appreciate the help.
 

nut-debug-20250227230438.zip

Hi and thanks again for this plugin and the support you provide for it.
I have one more question. Is there anything I can do to get the Power Draw graph to be displayed? The power consumption is displayed correctly in the status bar and in the settings, but the history graph cannot be displayed no matter what I do. Is it possible?
Thanks!

NUT_statistics.png

Has anyone gotten the IS-UNITY-DP to work with NUT?

I cant seem to get NUT to connect to IS-UNITY-DP at all

 

EDIT: Looks like I got it working with snmp v2c!

Edited by Reptar

I was having some issues with NUT that in the logs recommended enabling pollonly in upsconf but having done that now I'm seeing tons of "nut_libusb_get_report: Input/Output Error" messages in the log, and sometimes "nut_libusb_get_string: Pipe error", is this normal?

 

for reference, i have a CyberPower-1350VA UPS

 

tried taking off the pollonly  in upsconf, and now i'm seeing the same errors from before, which is the same error but with the additional suggestion to enable the pollonly flag

Mar 15 11:27:06 HTPC usbhid-ups[512654]: nut_libusb_get_report: Input/Output Error
Mar 15 11:27:08 HTPC usbhid-ups[512654]: #012Reconnecting. If you saw "nut_libusb_get_interrupt: Input/Output Error" or similar message in the log above, try setting "pollonly" flag in "ups.conf" options section for this driver!


any suggestions?

same issue here. cyberpower model: CP1500PFCLCDa

 

Mar 15 22:31:07 unraid usbhid-ups[4697]: nut_libusb_get_report: Input/Output Error
Mar 15 22:31:09 unraid usbhid-ups[4697]: nut_libusb_get_report: Input/Output Error
Mar 15 22:31:11 unraid usbhid-ups[4697]: nut_libusb_get_string: Input/Output Error
Mar 15 22:31:11 unraid usbhid-ups[4697]: nut_libusb_get_string: Pipe error
Mar 15 22:31:43 unraid usbhid-ups[4697]: nut_libusb_get_report: Input/Output Error

Apologies for the late response, driver spam is a common problem and can be mitigated with these settings:

  • Enable Rule-Based Syslog Filters (in NUT Settings)
  • Redirection for NUT Service Logs (in NUT Settings)

Generally if you don't have any problems with your UPS, these things can be filtered out / ignored safely. 🙂 

 

On 3/3/2025 at 2:29 PM, va1entin said:

Hi and thanks again for this plugin and the support you provide for it.
I have one more question. Is there anything I can do to get the Power Draw graph to be displayed? The power consumption is displayed correctly in the status bar and in the settings, but the history graph cannot be displayed no matter what I do. Is it possible?
Thanks!

NUT_statistics.png

 

It's possible your UPS does not report this value and it's calculated in the dashboards from other variables.

In this case it's not possible to show this in a graph as only actually reported variables can be shown in graphs.

 

You can hide the non-functioning graph though or change it to another (reported) variable of interest:

grafik.png.64ed643a9d238040afb2f5468357446c.png

 

6 hours ago, Rysz said:

Apologies for the late response, driver spam is a common problem and can be mitigated with these settings:

  • Enable Rule-Based Syslog Filters (in NUT Settings)
  • Redirection for NUT Service Logs (in NUT Settings)

Generally if you don't have any problems with your UPS, these things can be filtered out / ignored safely. 🙂 

 

 

It's possible your UPS does not report this value and it's calculated in the dashboards from other variables.

In this case it's not possible to show this in a graph as only actually reported variables can be shown in graphs.

 

You can hide the non-functioning graph though or change it to another (reported) variable of interest:

grafik.png.64ed643a9d238040afb2f5468357446c.png

 

i did have an issue with 2 cores maxing out with no VMs running or dockers causing it (and causing transcoding to fail), and restarting NUT seemed to fix it, which is why i think i need to take this endless logging more seriously.

 

do you think this fix would address the issue i had?

Hello,

 

Can we possibly change 

Time on Battery before Shutdown (Minutes):

from Minutes to Seconds?

  • 2 weeks later...

I am trying to get an ecoflow delta 3 plus to work with NUT. It is on the compatibility list, so it should work. However, I can't even get the NUT service to start. Right after installing the NUT plugin, without any changes to the settings, I get this error: 

 

"NUT was not able to start successfully - please check the SYSLOG for more information."

 

Syslog says this:

Writing NUT configuration...
rc.nut: Updating permissions for NUT...
rc.nut: Checking if the NUT Runtime Statistics Module should be enabled...
rc.nut: Disabling the NUT Runtime Statistics Module...
rc.nut: Network UPS Tools - Generic HID driver 0.53 (2.8.2)
rc.nut: USB communication driver (libusb 1.0) 0.47
rc.nut: libusb1: Could not open any HID devices: insufficient permissions on everything
rc.nut: No matching HID UPS found
rc.nut: Driver failed to start (exit status=1)
rc.nut: Network UPS Tools - UPS driver controller 2.8.2

 

Any help is appreciated.

1 minute ago, jquery said:

I am trying to get an ecoflow delta 3 plus to work with NUT. It is on the compatibility list, so it should work. However, I can't even get the NUT service to start. Right after installing the NUT plugin, without any changes to the settings, I get this error: 

 

"NUT was not able to start successfully - please check the SYSLOG for more information."

 

Syslog says this:

Writing NUT configuration...
rc.nut: Updating permissions for NUT...
rc.nut: Checking if the NUT Runtime Statistics Module should be enabled...
rc.nut: Disabling the NUT Runtime Statistics Module...
rc.nut: Network UPS Tools - Generic HID driver 0.53 (2.8.2)
rc.nut: USB communication driver (libusb 1.0) 0.47
rc.nut: libusb1: Could not open any HID devices: insufficient permissions on everything
rc.nut: No matching HID UPS found
rc.nut: Driver failed to start (exit status=1)
rc.nut: Network UPS Tools - UPS driver controller 2.8.2

 

Any help is appreciated.

 

Please post the NUT Debug Package that can be found on the NUT Settings page.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.