UPS.CONF(5) NUT Manual UPS.CONF(5) (NAME) ups.conf - Network UPS Tools (DESCRIPTION) upsdrvctl(8) ( nutupsdrv(8) ) nut-driver-enumerator(8) NUT upsd(8) . (global) . . "default" upsd(8) . driver port . . : [myups] driver = blazer_ser port = /dev/ttyS0 desc = "Web server UPS" : [bigups] driver = apcsmart port = /dev/cua00 cable = 940-0095B sdtype = 2 desc = "Database server UPS" apcsmart(8) "cable" "sdtype" . () . : [windows-ups] driver = mge-shut port = "\\\\.\\COM10" desc = "UPS on a Windows machine" (IMPORTANT NOTES) o (ASCII) ( ). o upsd ( ) . chown root:nut chmod 640 . o ( ) NUT . nobody:nogroup . o NUT ups.conf . user group RUN_AS_USER / RUN_AS_GROUP . o . . o . (GLOBAL DIRECTIVES) chroot . chroot(2) . . driverpath . . /usr/local/ups/bin . statepath . upsd ( /var/state/ups ). upsd ups.conf upsd.conf . NUT_STATEPATH . maxstartdelay . . maxretry . () . retrydelay . . . nowait . upsdrvctl () . ( ) . NUT_IGNORE_NOWAIT ( systemd). retrydelay . () maxretry. . . pollinterval . . . . ( usbhid-ups(8) snmp- ups(8) nutdrv_qx(8)) pollfreq . . synchronous . (asynchronous) ( synchronous=auto). upsd ( Named pipe ) . ePDU . : write XX bytes to socket Y failed synchronous ( = yes) upsd . . auto no ( ) "Resource temporarily unavailable" . user . NUT . -u nutupsdrv(8) . group . (/ ) NUT . -g nutupsdrv(8) . (hot-plug) ( ) . debug_min INTEGER . upsdrvctl(8) . -D . LIBUSB_DEBUG INTEGER . NUT USB LibUSB 4 ("All messages are emitted") . NUT . : o o (UPS FIELDS) driver . . . nutupsdrv(8) . port . . /dev/ttyS0 . FreeBSD /dev/cuaa0 . "\\\\.\\COM1" ( ). user . (/ ) NUT . -u nutupsdrv(8) . (hot-plug) ( ) . group . (/ ) NUT . -g nutupsdrv(8) . (hot-plug) ( ) . sdorder . . upsdrvctl 0 1 2 . 1- . 0 . sdcommands . () . ( ) shutdown.default . ( ). "OFF" ( ) . : ups.conf nutshutdown NUT . (beeper) INSTCMD . allow_killpower . driver.killpower upsdrv_shutdown() NUT -k . upsrw(8) driver.flag.allow_killpower . desc . upsd . nolock . . . . Mac OS X . ignorelb . ( ). : battery.charge < battery.charge.low battery.runtime < battery.runtime.low battery.charge.low / battery.runtime.low ups.conf : override.battery.charge.low = 30 override.battery.runtime.low = 180 / ( ) . ! maxstartdelay . . upsdrvctl . . upsdrvctl ( maxretry>1 ) "" . upsdrvctl (kill) . . maxretry . . . retrydelay . . . synchronous . . usb_set_altinterface[=altinterface] . USB usb_set_altinterface(0) NUT 2.7.2 . bAlternateSetting ( lsusb ) USB . usb_set_altinterface() Mac OS X . nut-upsdev . usb_config_index, usb_hid_rep_index, usb_hid_desc_index, usb_hid_ep_in, usb_hid_ep_out . 0 ( ). . usb_hid_desc_index wDescriptorLength ( ) lsusb . default. . : default.input.voltage.nominal = 230 . override. . . ( ): override.battery.voltage.nominal = 12 ! . . . debug_min INTEGER . . debug_min . -D . LIBUSB_DEBUG INTEGER . NUT USB LibUSB 4 ("All messages are emitted") . : o o (INTEGRATION) upsdrvctl(8) . . . upsd(8) . "doghouse" ups.conf "snoopy" upsc(8) "snoopy@doghouse" . (SEE ALSO) upsd(8), nutupsdrv(8), upsdrvctl(8), upsdrvsvcctl(8) (Internet resources) NUT (Network UPS Tools): Network UPS Tools 2.8.5 06/21/2026 UPS.CONF(5)