Get a Quote     (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Configuring UPS Service

  2 minute read.

Last Modified 2022-12-09 11:01 EST

TrueNAS uses Network UPS Tools NUT to provide UPS support. After connecting the TrueNAS system UPS device, configure the UPS service by going to System settings > Services, finding UPS, and clicking .

See [UPS Service Screen]({{ relref “” }}) for details on the UPS service settings.

Some UPS models are unresponsive with the default polling frequency (default is two seconds). TrueNAS displays the issue in logs as a recurring error like libusb_get_interrupt: Unknown error. If you get an error, decrease the polling frequency by adding an entry to Auxiliary Parameters (ups.conf): pollinterval = 10.

upsc(8) can get status variables like the current charge and input voltage from the UPS daemon. Run this in System Settings > Shell using the syntax upsc ups@localhost. The upsc(8) manual page has other usage examples.

upscmd(8) can send commands directly to the UPS, assuming the hardware supports it. Only users with administrative rights can use this command. You can create them in the Extra Users field.

For USB devices, the easiest way to determine the correct device name is to set Show console messages in System Settings > Advanced. Plug in the USB device and look for a /dev/ugen or /dev/uhid device name in the console messages.
A UPS with adequate capacity can power multiple computers. One computer connects to the UPS data port with a serial or USB cable. This primary system makes UPS status available on the network for other computers. The UPS powers the secondary computers, and they receive UPS status data from the primary system. See the NUT User Manual and NUT User Manual Pages.

Related Content