Get a Quote     (408) 943-4100   TrueNAS Discord VendOp_Icon_15x15px Enterprise Support
TrueNAS.com Software Systems Company Community Security iX Portal Download
TrueNAS Enterprise TrueNAS SCALE TrueNAS CORE Compare Editions TrueCommand Software Status FreeNAS
Compare Systems F-Series M-Series H-Series R-Series Mini Series
Contact Us iXsystems Careers Clients Reviews
TrueNAS GitHub Community Forum Discord TrueNAS Merch Store
Use Cases Analytics Backup and Archival Cloud Data Mobility File Sharing iX Storj Media Creation Surveillance Virtualization
Industry Education Government Healthcare Research / AI / ML Media & Entertainment
Enterprise Support Community Support Documentation TrueNAS Security FAQ ZFS Overview
TrueNAS Blog Solution Guides Datasheets Case Studies Videos TrueCommand Cloud
Download TrueNAS SCALE Download TrueNAS CORE Get TrueNAS Enterprise Compare TrueNAS Editions Contact an Enterprise Specialist
  1. TrueNAS CORE
  2. /
  3. Configuration Tutorials
  4. /
  5. Services
  6. /
  7. Configuring UPS Service
Edit page
TrueNAS CORETrueNAS CORE Version Documentation
This content follows the TrueNAS CORE 13.0 releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Configuring UPS Service

  2 minute read.

TrueNAS uses NUT (Network UPS Tools) to provide UPS support. Connect the TrueNAS system to the UPS device. Configure the UPS service by going to Services, finding the UPS entry, and clicking edit edit icon.

TrueNAS Enterprise
TrueNAS High Availability (HA) systems are not compatible with uninterruptible power supplies (UPS).
UPS Service Screen
Figure 1: UPS Service Screen (Top)
UPS Service Screen
Figure 2: UPS Service Screen (Bottom)

See UPS Screen for more information on UPS settings. Some UPS models can be unresponsive with the default polling frequency. This shows in TrueNAS logs as a recurring error like libusb_get_interrupt: Unknown error. The default polling frequency is two seconds. Decrease the polling frequency by adding an entry to Auxiliary Parameters (ups.conf): pollinterval = 10. This should resolve the error.

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

If the hardware supports sending the command, upscmd(8) can send commands directly to the UPS. Only users with administrative rights can administer these commands. Create these users in the Extra Users field.

Determine the correct device name for the UPS. Go to System > Advanced and select Show console messages. 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. Connect one computer 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 secondary computers receive UPS status data from the primary computer. The secondary computers receive power from the UPS. See the NUT User Manual and NUT User Manual Pages.

Related Content

Have more questions or want to discuss your specific configuration? For further discussion or assistance, see these resources:

Found content that needs an update? You can suggest content changes directly! To request changes to this content, click the Feedback button located on the middle-right side of the page (might require disabling ad blocking plugins).