Factsheet
Network UPS Tools (NUT)
Developers Evgeny "Jim" Klimov
Arnaud Quette
Arjen de Korte
Charles Lepple
Numerous contributors (..)
Arnaud Quette
Arjen de Korte
Charles Lepple
Numerous contributors (..)
Release March 8, 1998; 28 years ago (1998-03-08)
Network UPS Tools (NUT)
Developers Evgeny "Jim" Klimov
Arnaud Quette
Arjen de Korte
Charles Lepple
Numerous contributors (..)
Arnaud Quette
Arjen de Korte
Charles Lepple
Numerous contributors (..)
Release March 8, 1998; 28 years ago (1998-03-08)
Ubuntu
manpages.ubuntu.com › focal › man(8)
Ubuntu Manpage: usbhid-ups - Driver for USB/HID UPS equipment
usb 2-1: control timeout on ep0in usb 2-1: usbfs: USBDEVFS_CONTROL failed cmd usbhid-ups rqt 128 rq 6 len 256 ret -110 · In this case, simply modify the general parameter "pollinterval" to a higher value (like 10 for 10 seconds). This should solve the issue. You have forgotten to install the hotplug files, as explained in the INSTALLATION section above.
ArchWiki
wiki.archlinux.org › title › Network_UPS_Tools
Network UPS Tools - ArchWiki
For many UPS connected by USB, use the usbhid-ups(8) driver. For UPS with serial port, use port=/dev/ttySX, where X is the number of serial port (Example: /dev/ttyS1).
TED Felix
tedfelix.com › software › nut-network-ups-tools.html
HOWTO: Set Up NUT, the Network UPS Tools
[serverups] driver = usbhid-ups port = auto desc = "Server UPS" - Install udev rules for usbhid-ups (see man usbhid-ups INSTALLATION) sudo cp /lib/udev/rules.d/52-nut-usbups.rules /etc/udev/rules.d/ reboot - Set up /var/run/nut per http://www.blasterspike.it/2011/03/28/how-to-install-nut-on-ubuntu-10-10-maverick-meerkat/ sudo mkdir /var/run/nut sudo chown root:nut /var/run/nut sudo chmod 770 /var/run/nut - Test the ups.conf file: sudo upsdrvctl start Normal output: Network UPS Tools - UPS driver controller 2.6.3 Network UPS Tools - Generic HID driver 0.35 (2.6.3) USB communication driver 0.31 Using subdriver: CyberPower HID 0.3
GitHub
github.com › networkupstools › nut › blob › master › drivers › usbhid-ups.c
nut/drivers/usbhid-ups.c at master · networkupstools/nut
/* usbhid-ups.c - Driver for USB and serial (MGE SHUT) HID UPS units
Author networkupstools
Debian Manpages
manpages.debian.org › testing › nut-server › usbhid-ups.8.en.html
usbhid-ups(8) — nut-server — Debian testing — Debian Manpages
October 17, 2025 - Note for instance, it was found that Eaton MGE Ellipse Max 1500 FR UPS firmware stops responding every few hours, which causes usbhid-ups driver to detect an libusb insufficient memory error; in this case, when the usbhid-ups driver tries to reconnect too early, the activity sometimes led the UPS firmware to crash and turn off the load immediately! Setting this parameter to 30 seconds solved this problem (while 20 seconds were not enough). This driver may be not built by default. You can build it by installing prerequisites and using configure --with-usb=yes.
Sudoku Helper
mathstat.dal.ca › ~selinger › ups › backups.html
Peter Selinger: Linux and the APC Back-UPS ES
Trouble shooting: if you get an error message saying "usb.h: No such file or directory", then you did not install libusb correctly. Go back to step 1. above. Create the "ups" user. The driver and daemon will run with this user id. ... Configure the driver. As root, create and edit the following file: /usr/etc/ups.conf: ---------------------------------------------------------------------- [apc] driver = usbhid-ups port = auto desc = "APC Back-UPS ES 650" ---------------------------------------------------------------------- Set up the ownership and permissions of the file you just created:
openSUSE Manpages
manpages.opensuse.org › leap-16.0 › nut › usbhid-ups(8)
usbhid-ups(8) — nut
April 1, 2025 - Note for instance, it was found ... when the usbhid-ups driver tries to reconnect too early, the activity sometimes led the UPS firmware to crash and turn off the load immediately! Setting this parameter to 30 seconds solved this problem (while 20 seconds were not enough). This driver is not built by default. You can build it by using "configure --with-usb=yes". Note that it will also install other USB ...
GitHub
gist.github.com › clungzta › 2b5f737f006e1530cc59
Overview of how to install OpenUPS2 using Linux, using the usbhid-ups driver for NUT (Network UPS Tools), allows you to view ups status, battery voltage and temperature etc. · GitHub
[openups2] driver = usbhid-ups port = auto vendorid = 04d8 productid = d005 pollfreq = 30 desc = "Mini-Box OpenUPS2"
manned.org
manned.org › usbhid-ups › ae1d1c6b
usbhid-ups - manned.org
For instance: [mge] driver = usbhid-ups port = auto vendorid = 0463 [tripplite] driver = usbhid-ups port = auto vendorid = 09ae KNOWN ISSUES AND BUGS Got EPERM: Operation not permitted upon driver startup You have forgotten to install the hotplug files, as explained in the INSTALLATION section ...
Linux Man Pages
linux.die.net › man › 8 › usbhid-ups
usbhid-ups(8): Driver for USB/HID UPS equipment - Linux man page
usb 2-1: control timeout on ep0in usb 2-1: usbfs: USBDEVFS_CONTROL failed cmd usbhid-ups rqt 128 rq 6 len 256 ret -110 · In this case, simply modify the general parameter "pollinterval" to a higher value (like 10 for 10 seconds). This should solve the issue. Got EPERM: Operation not permitted upon driver startup · You have forgotten to install the hotplug files, as explained in the INSTALLATION section above.
Arch Linux Man Pages
man.archlinux.org › man › usbhid-ups.8.en
usbhid-ups(8) — Arch manual pages
Note For instance, it was found ... when the usbhid-ups driver tries to reconnect too early, the activity sometimes led the UPS firmware to crash and turn off the load immediately! Setting this parameter to 30 seconds solved this problem (while 20 seconds were not enough). This driver may be not built by default. You can build it by installing prerequisites ...
Top answer 1 of 5
6
Try to use the config from this blogger: http://risc-a-day.blogspot.hu/2014/09/getting-my-ups-to-work-with-linux.html
(Excerpts:
lsusb
...
Bus 008 Device 002: ID 0463:ffff MGE UPS Systems UPS
... edit /etc/nut/ups.conf and add section for the UPS device itself:
...
[myups]
driver = usbhid-ups
port = auto
vendorid = 0463
pollfreq = 30
...
$ sudo upsdrvctl start
...
$ upsc myups
battery.charge: 75
battery.runtime: 1737
battery.type: PbAc
device.mfr: EATON
device.model: 5E 1100i
device.type: ups
driver.name: usbhid-ups
driver.parameter.pollfreq: 30
driver.parameter.pollinterval: 2
driver.parameter.port: auto
driver.parameter.vendorid: 0463
driver.version: 2.6.4
driver.version.data: MGE HID 1.31
driver.version.internal: 0.37
input.voltage: 229.0
outlet.1.status: on
outlet.desc: Main Outlet
outlet.id: 1
outlet.switchable: no
output.frequency: 49.9
output.frequency.nominal: 50
output.voltage: 233.0
output.voltage.nominal: 230
ups.beeper.status: enabled
ups.delay.shutdown: 20
ups.firmware: 01.04.0018
ups.load: 12
ups.mfr: EATON
ups.model: 5E 1100i
ups.power.nominal: 1100
ups.productid: ffff
ups.start.battery: yes
ups.status: OL CHRG
ups.timer.shutdown: -1
ups.vendorid: 0463
)
2 of 5
1
once try these things,
You can use lsusb to find out the bus and device number
Then change permission to the device
chmod 0666 /dev/bus/usb/[bus number]/[device number]
as for details go with the following: trouble starting Network UPS Tools with a Eaton 3S UPS
Reidmain
reidmain.com › 2025 › 01 › 07 › home-assistant-nut
Connecting a UPS to Home Assistant using Network UPS Tools (NUT) | Reid Main
Step-by-step instructions on how to install Network UPS Tools (NUT) on a Raspberry Pi and access it via Home Assistant.
Reddit
reddit.com › r/homelab › nut with old serial usb ups
r/homelab on Reddit: NUT With old Serial USB UPS
October 15, 2024 -
Hello everyone, I’ve recently restored an old STD60S UPS from Control Systems to working condition. It’s a rather unknown brand, but they make good UPS units. I bought a Serial to USB adapter on Amazon to control my UPS, as it’s currently powering a Proxmox server. I discovered NUT (Network UPS Tools), which seems to be a great solution for managing my UPS in case of a power outage; specifically, I want to set it up so that if the batteries drop below 20%, the NUT system sends a shutdown signal to my Proxmox server.
I downloaded the “proprietary” software for this UPS on a Windows VM, and it works correctly after installing the software and the drivers for the Serial to USB converter. The issue is that I need to install the UPS monitor with NUT on the entire Proxmox node, but unfortunately, I’m not sure how to do it or which driver to use.
I’ve installed NUT on my Proxmox server, but when I run nut-scanner -U, no device is detected. I can’t find my UPS on the NUT compatibility list, although from what I understand, NUT works with most UPS units, even those that aren’t listed.
What driver would you recommend using with NUT for my UPS, which has serial port control, when using a Serial to USB cable?
Top answer 1 of 5
1
Yes, you need to scan the serial port that your USB adapter has created. Check dmesg what it shows up as or check /dev with it unplugged and plugged in (should be a new one added).
2 of 5
1
What does the "proprietary" software look like? What's it called? NUT doesn't magically work with all UPS units, it's more that many of those UPS units happen to use a few common protocols, so nutdrv_qx would be my first guess if the device exposes a serial port over USB (the other type being a USB HID 'Battery' device).
Alpine Linux
wiki.alpinelinux.org › wiki › Nut-ups
Nut-ups - Alpine Linux
April 17, 2026 - This wiki page shows how to install and configure the Network UPS Tools (NUT) package to monitor and report the statistics for a USB-attached Uninterruptible Power Supply (UPS) and make the UPS status available over the network, so that it can be monitored and used to trigger actions in a home automation system like Home Assistant.
Command Not Found
command-not-found.com › usbhid-ups
command-not-found.com – usbhid-ups
Install usbhid-ups command on any operating system and in Docker.
Assorted Nerdery
bostonenginerd.com › posts › home-ups
Setting up a UPS for a home lab – Assorted Nerdery
January 23, 2021 - > opkg update > opkg install nut nut-common nut-upsmon nut-upscmd nut-server nut-driver-usbhid-ups
ManKier
mankier.com › home › nut
usbhid-ups: Driver for USB/HID UPS equipment | Man Page | System Administration | nut | ManKier
Unlike previous versions of this driver, it is now possible to control multiple UPS units simultaneously with instances of this driver running in parallel, provided they can be distinguished by setting some combination of the device-matching options. ... [mge] driver = usbhid-ups port = auto vendorid = 0463 [tripplite] driver = usbhid-ups port = auto vendorid = 09ae
NUT
networkupstools.org › docs › user-manual.chunked › _installation_instructions.html
5. Installation instructions
See also Building NUT for in-place upgrades or non-disruptive tests. Configure the source tree for your system. Add the --with-user and --with-group switch to set the user name and group that you created above. ... If you need any other switches for configure, add them here. For example: to build and install USB drivers, add --with-usb (note that you need to install libusb development package or files).
Debian Manpages
manpages.debian.org › jessie › nut-server › usbhid-ups(8)
usbhid-ups(8) — nut-server — Debian jessie — Debian Manpages
usb 2-1: control timeout on ep0in usb 2-1: usbfs: USBDEVFS_CONTROL failed cmd usbhid-ups rqt 128 rq 6 len 256 ret -110 · In this case, simply modify the general parameter "pollinterval" to a higher value (like 10 for 10 seconds). This should solve the issue. You have forgotten to install the hotplug files, as explained in the INSTALLATION section above.