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

1 minute ago, efisher said:

I'm having the same problem. I can see that the Power Draw is being read from the Cyberpower UPS as the Watts are show in the NUT footer, but the chart only reports "Waiting for Data...". Does anyone know how to get the Power Draw chart to update based on the draw reported from the UPS?

You can use the overrides to define custom variables you want to monitor, any existing numeric variables should be possible:
grafik.png

  • Replies 2.1k
  • Views 458.8k
  • 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

14 minutes ago, Rysz said:

You can use the overrides to define custom variables you want to monitor, any existing numeric variables should be possible:
grafik.png

I think my problem is that ups.realpower is not provided via the UPS driver. My confusion is, if this isn't present in the driver, how is it showing up in the NUT Footer? Is that number calculated? If so, is it possible to do the same calculation in the statistics overrides?

root@Tower:/boot/config/plugins/nut-dw/ups# upsc ups

battery.charge: 100

battery.charge.low: 10

battery.charge.warning: 20

battery.mfr.date: CPS

battery.runtime: 2043

battery.runtime.low: 300

battery.status: 100%

battery.type: PbAcid

battery.voltage: 13.8

battery.voltage.nominal: 12

device.mfr: CPS

device.model: ST Series

device.type: ups

driver.debug: 0

driver.flag.allow_killpower: 0

driver.name: usbhid-ups

driver.parameter.interrupt_pipe_no_events_tolerance: -1

driver.parameter.pollfreq: 12

driver.parameter.pollinterval: 2

driver.parameter.port: auto

driver.parameter.synchronous: auto

driver.state: quiet

driver.version: 2.8.3

driver.version.data: CyberPower HID 0.83

driver.version.internal: 0.62

driver.version.usb: libusb-1.0.28 (API: 0x0100010A)

input.transfer.high: 140

input.transfer.low: 96

input.voltage: 122.0

input.voltage.nominal: 0

output.voltage: 122.0

ups.beeper.status: enabled

ups.delay.shutdown: 60

ups.delay.start: 120

ups.firmware: BF02105B2

ups.load: 20

ups.mfr: CPS

ups.model: ST Series

ups.productid: 0501

ups.realpower.nominal: 375

ups.status: OL

ups.test.result: Done and passed

ups.timer.shutdown: -60

ups.timer.start: -60

ups.vendorid: 0764

Edited by efisher

Just now, efisher said:

I think my problem is that ups.realpower is not provided via the UPS driver. My confusion is, if this isn't present in the driver, how is it showing up in the NUT Footer? Is that number calculated? If so, is it possible to do the same calculation in the statistics overrides?

At the moment the charts can only monitor variables that are actually reported by the UPS, not those calculated inside the GUI.

I guess many people use external charting solutions (Grafana, ...) with NUT, where you can do such more complex manipulations.

It may well be possible in the future at some point, but I can't provide a time-frame on that just yet, sorry.

So, to confirm, the NUT footer is indeed using a calculation, but NUT statistics can't use a calculation at this time. Is that correct?

5 minutes ago, Rysz said:

At the moment the charts can only monitor variables that are actually reported by the UPS, not those calculated inside the GUI.

I guess many people use external charting solutions (Grafana, ...) with NUT, where you can do such more complex manipulations.

It may well be possible in the future at some point, but I can't provide a time-frame on that just yet, sorry.

Thanks for this reply, will look into graphana meanwhile.

35 minutes ago, efisher said:

So, to confirm, the NUT footer is indeed using a calculation, but NUT statistics can't use a calculation at this time. Is that correct?

Yes, that's correct, the charts receive the information straight from the backend and the calculation is done in the frontend for visuals.

  • 2 weeks later...

@Rysz what command in cli ,we can get package name of current backend like (nut-2.8.3-x86_64-2master.ssl31) ?

1 hour ago, Masterwishx said:

@Rysz what command in cli ,we can get package name of current backend like (nut-2.8.3-x86_64-2master.ssl31) ?

find /var/log/packages/ -type f -iname 'nut*' ! -iname 'nut-plugin*' -printf '%f\n' 2>/dev/null

My previous UPS was replaced by the manufacturer because it alerted me that the batteries needed replacement. However, I installed the replacement unit, and it passed the test. But I'm still getting emails that my batteries need replacement. What to do? My UPS is APC Back-UPS BX2200MI

I tried clicking the "NUT Debug Package (.zip)" in NUT settings, but it doesn't do anything.

50 minutes ago, HHUBS said:

My previous UPS was replaced by the manufacturer because it alerted me that the batteries needed replacement. However, I installed the replacement unit, and it passed the test. But I'm still getting emails that my batteries need replacement. What to do? My UPS is APC Back-UPS BX2200MI

I tried clicking the "NUT Debug Package (.zip)" in NUT settings, but it doesn't do anything.

This is a known firmware issue with that series, please check out this pinned post for a solution:
https://forums.unraid.net/topic/60217-plugin-nut-v2-network-ups-tools/page/70/#comment-1494093

As for the debug package, it should open a download (see if your browser does not block it), but may take a while (~30 secs max) at that.

1 hour ago, Rysz said:

This is a known firmware issue with that series, please check out this pinned post for a solution:
https://forums.unraid.net/topic/60217-plugin-nut-v2-network-ups-tools/page/70/#comment-1494093

As for the debug package, it should open a download (see if your browser does not block it), but may take a while (~30 secs max) at that.

Ok, done with the steps.. Question, is this right or should I NOT indent it?

image.png

3 minutes ago, HHUBS said:

Ok, done with the steps.. Question, is this right or should I NOT indent it?

image.png

The parser does not care about whitespace between words. If you like to indent things with tabs or spaces, feel free to do it.

Good day, please tell me if it is possible to somehow make friends with NUT and Vinga LED 850VA metal case with USB (VPE-850PRMU)? Attempts to search on the Internet did not yield any results (Thanks in advance

16 minutes ago, Owerrride said:

Good day, please tell me if it is possible to somehow make friends with NUT and Vinga LED 850VA metal case with USB (VPE-850PRMU)? Attempts to search on the Internet did not yield any results (Thanks in advance

Did you try if "Auto Config" detects the UPS?

36 minutes ago, Rysz said:

Did you try if "Auto Config" detects the UPS?

yes, its no work(

I purchased one of those new LiFePO4 UPS from Goldenmate -- it's the new one with the USB communication port (1000VA/800W - "2025 Upgraded Pro Ver."). I don't see this brand showing up in the thread so I thought I would surface it here. I can get it communicating (somewhat) with the plugin, but every time it (the polling or communication) refreshes I get a notification on my UnRaid dashboard that says the "UPS on Battery", and then a second later "UPS Online, any planned shutdowns were cancelled". I'm asuming the standard USBHID-UPS driver is polling it in a certain way that is causing this flip flop in the notification.

Let me know if I should attach the NUT Debug package / UPS Data File here so that I can help diagnose further.

Many thanks!

Edited by EricB

9 hours ago, EricB said:

I purchased one of those new LiFePO4 UPS from Goldenmate -- it's the new one with the USB communication port (1000VA/800W - "2025 Upgraded Pro Ver."). I don't see this brand showing up in the thread so I thought I would surface it here. I can get it communicating (somewhat) with the plugin, but every time it (the polling or communication) refreshes I get a notification on my UnRaid dashboard that says the "UPS on Battery", and then a second later "UPS Online, any planned shutdowns were cancelled". I'm asuming the standard USBHID-UPS driver is polling it in a certain way that is causing this flip flop in the notification.

Let me know if I should attach the NUT Debug package / UPS Data File here so that I can help diagnose further.

Many thanks!

In Unraid's NUT Settings, please first stop NUT, then set these settings (beware DRIVER debug level, NOT Monitor) as shown below:

437687645-061c85f4-2e6c-4ac6-8964-39fd447b9059.png

437687628-21a8cacb-ff09-4458-996a-651235748f17.png

Then start NUT and wait for a bit for the OL/OB flicker to occur, after which you can download the logfile and post it here.

It is important to download the log file (clicking the download icon) and not copy it out of the log viewer (clicking the book icon), as the log viewer truncates any parts that are exceeding 200 lines (which a lot of debug lines will probably exceed).

You can afterwards revert the above changed settings back to their original states/defaults. 😉

9 hours ago, Rysz said:

In Unraid's NUT Settings, please first stop NUT, then set these settings (beware DRIVER debug level, NOT Monitor) as shown below:

437687645-061c85f4-2e6c-4ac6-8964-39fd447b9059.png

437687628-21a8cacb-ff09-4458-996a-651235748f17.png

Then start NUT and wait for a bit for the OL/OB flicker to occur, after which you can download the logfile and post it here.

It is important to download the log file (clicking the download icon) and not copy it out of the log viewer (clicking the book icon), as the log viewer truncates any parts that are exceeding 200 lines (which a lot of debug lines will probably exceed).

You can afterwards revert the above changed settings back to their original states/defaults. 😉

Thank you so much for your guidance. I'm attaching the LOG file. What's great about sending to file, and not to monitor, is that I do NOT see the blip... at least I don't see it in the Unraid Notification bell. I had something like 300 notifications yesterday :)
Let me know if I can provide anything else to you. Many thanks for your help!nut.log

Hello Everyone,

I bought a Tecnoware UPS ERA PLUS 1500 and hit auto config after plugin into unraid.

Now I see the load and status but no battery charge.

Below details

/etc/nut/ups.conf

[ups]

driver = "nutdrv_qx" # alternately: blazer_usb nutdrv_atcl_usb

port = "auto"

vendorid = "0001"

productid = "0000"

product = "MEC0003"

vendor = "MEC"

# bus = "001"

# device = "003"

# busport = "013"

I found an open inssue on NUT github to a similar hw:https://github.com/networkupstools/nut/issues/747

Can someone please help me understand if I can see the missing details?

Thanks

nut-debug-20250720094531.zip

  • 3 weeks later...

Hi,

No big problem. I just installed an UPS last week.

Meanwhile, I updated unRAID to beta 7.2.

I wanted to tell you that the footer has now disappeared...

Thanks for your work.

Mike

28 minutes ago, mmm77 said:

Hi,

No big problem. I just installed an UPS last week.

Meanwhile, I updated unRAID to beta 7.2.

I wanted to tell you that the footer has now disappeared...

Thanks for your work.

Mike

Thanks, I'm aware of the issue and an update is in the works, which will also include NUT 2.8.4 (which was released today).

In general all my plugins target the stable branch OS versions, so things can break when using any such beta branch OS versions.

19 hours ago, Rysz said:

which will also include NUT 2.8.4

Thanks waiting for it :)

I updated the plugin to include latest NUT 2.8.4 and also fix the footer issue in the recent OS beta version.

I'm aware of the other minor UI issues, these will require a larger overhaul, which I'm not sure how I'll navigate yet.

This'll be a continuous effort and targeted towards future OS stable branch releases with the plugin otherwise functional.

Hey everyone, I recently had to buy a new UPS. I decided on an "APC Back UPS BX – BX1200MI-GR."

Can anyone tell me why I keep getting these alerts? I didn't have that with my Green Cell UPS...

Thanks

alerts.png

alert.png

nut-ups.dev nut-debug-20250816133125.zip

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.