UPSMON.CONF(5) NUT Manual UPSMON.CONF(5) (NAME) upsmon.conf - upsmon Network UPS Tools (NUT) (DESCRIPTION) upsmon(8) . . upsmon . MONITOR MINSUPPLIES ( NUT 0 ) POWERDOWNFLAG ( <<>> (primary) UPS ). . (IMPORTANT NOTES) o ASCII ( ). o ( ) upsmon . chown root:nut chmod 640 . o ( ) NUT . nobody:nogroup . o NUT . user group RUN_AS_USER / RUN_AS_GROUP . o . (CONFIGURATION DIRECTIVES) DEADTIME seconds upsmon UPS <<>> (dead) . . upsmon UPS (POLLFREQ POLLFREQALERT ) . UPS (stale) . DEADTIME (dead) . UPS (low battery) . UPS . . : DEADTIME POLLFREQ POLLFREQALERT . upsmon UPS <<>> . : POLLFREQ . FINALDELAY seconds (FSD) UPS upsmon NOTIFY_SHUTDOWN . SHUTDOWNCMD . . ( NOTIFYCMD) . UPS . . UPS 0 . FINALDELAY HOSTSYNC upsmon . HOSTSYNC seconds upsmon (primary) . . UPS ( + "FSD": ) . HOSTSYNC upsmon . . UPS HOSTSYNC FSD . upsmon ( ) . "OB LB" ( ) . MINSUPPLIES num . 1 . / . HP NetServer LH4 2 . UPS ! big-servers.txt docs . << >> upsmon(8) . MONITOR system powervalue username password type UPS MONITOR . upsmon . . MONITOR upsmon.conf . o system UPS . : [@[:]] "localhost" . : o "su700@mybox" UPS "su700" "mybox" . . o "fenton@bigbox:5678" UPS "fenton" "bigbox" upsd(8) "5678" . o powervalue UPS . UPS 1 . . UPS powervalue 0 . upsmon UPS . o username password upsd.users(5) upsd . "observer" "abcd" MONITOR ( ): MONITOR myups@bigserver 1 observer abcd secondary upsd.users bigserver : [observer] password = abcd upsmon secondary [upswired] password = blah upsmon primary upsmon bigserver : MONITOR myups@bigserver 1 upswired blah primary o type upsd(8) . "primary" "secondary" . upsmon(8) . upsd.users . NOCOMMWARNTIME seconds upsmon UPS NOTIFY_NOCOMM . . . POLLFAIL_LOG_THROTTLE_MAX count upsmon POLLFREQ ( "Data stale" "Driver not connected") . syslog . ( max=1 ) ( / ). . NOTIFYCMD command upsmon . . NOTIFYTYPE . upssched(8) NOTIFYCMD . NOTIFY EXEC NOTIFYFLAG . NOTIFYFLAG . . docs/scheduling.txt . . NOTIFYCMD "/path/to/script --foo --bar" -- upsmon (fork) . NOTIFYCMD . . NOTIFYMSG type message upsmon . . NOTIFYMSG ONLINE "UPS %s is getting line power" NOTIFYMSG ONBATT "Someone pulled the plug on %s" %s UPS . . NOTIFYMSG NOCOMM "Someone stole UPS %s" type: ONLINE ONBATT LOWBATT ( ) FSD (FSD = << >> "Forced Shutdown") COMMOK UPS COMMBAD UPS SHUTDOWN SHUTDOWN_HOSTSYNC REPLBATT UPS NOCOMM UPS ( ) NOPARENT upsmon - CAL UPS NOTCAL UPS OFF NOTOFF BYPASS ( ) NOTBYPASS ECO ECO ( ) upsmon(8) . NOTECO ECO ( ) ALARM (ups.alarm ) message %s ups.alarm . NOTALARM ( ) OVER NOTOVER TRIM NOTTRIM BOOST NOTBOOST OTHER ups.status message %s . NOTOTHER SUSPEND_STARTING // SUSPEND_FINISHED // UPS NOTIFYFLAG type flag[+flag]... upsmon (wall) /bin/wall syslog upsmon Event Log . . : NOTIFYFLAG ONLINE SYSLOG NOTIFYFLAG ONBATT SYSLOG+WALL+EXEC : SYSLOG syslog WALL /bin/wall EXEC NOTIFYCMD ( ) IGNORE IGNORE . POLLFREQ seconds upsmon upsd(8) . . . . POLLFREQ . DEADTIME ( ) . . upsd UPS . . pollfreq NUT usbhid-ups(8) ( ) . POLLFREQALERT seconds UPS upsmon . POLLFREQ . POLLFREQ . . POLLFREQ . POWERDOWNFLAG filename upsmon UPS . upsdrvctl shutdown NUT ( ) upsmon -K . /etc/killpower ( (/var)/run (/var)/run/nut ) . C:\\Temp\\killpower ( C:/Temp/killpower ). "halted" . UPS (contact-closure) genericups . upsmon ! config-notes.txt docs . : "Configuring automatic shutdowns for low battery events" . OFFDURATION seconds NUT << >> (administrative OFF) UPS ePDU . ( FSD upsmon MONITOR -- ) "OFF" "CAL" -- FSD upsmon . "OFF" . () "OFF" ( ). "OFF" . OVERDURATION seconds UPS . . OVERDURATION ( ) UPS . UPS ( ). UPS . -1 () . UPS . UPS . OBLBDURATION seconds NUT UPS ("OB") ("LB") MINSUPPLIES (FSD) . ( OBLBDURATION ) . "OB LB" . FSD "OB LB" . 0 () . OBLBDURATION HOSTSYNC upsmon () HOSTSYNC : upsmon OBLBDURATION "OB LB" . UPS FSD . RBWARNTIME seconds UPS upsmon NOTIFY_REPLBATT . ( ) . . ALARMCRITICAL 0 | 1 NUT UPS UPS / . UPS ALARM . . upsmon UPS ALARM . RUN_AS_USER username upsmon root SHUTDOWNCMD . "nobody" "nut" "ups" NUT . "nobody" upsmon.conf root ( NUT ). upsmon . upsmon . NUT . "nutmon" . . upsmon upsmon.conf . . upsmon SHUTDOWNCMD upsmon . NUT ( ) root . -- upsmon nut sudo pfexec RBAC. << >> ( sudoers LDAP ) -- ( NUT ). SHUTDOWNCMD command upsmon . MINSUPPLIES . upsmon . . : SHUTDOWNCMD "/sbin/shutdown -h +0" SHUTDOWNEXIT boolean|number upsmon NUT NUT UPS . ( "Yes") <<>> ( ) <<>> UPS ( ) -- ( upsmon ). UPS . HOSTSYNC NUT . upssched dummy-ups battery.charge battery.runtime . (yes/on/true no/off/false) ( ) SHUTDOWNCMD . () . CERTPATH certificate file or database SSL . NSS: ( ). . OpenSSL: CA PEM upsd . CA . (subject name hash) . CERTIDENT certificate name database password SSL NSS . OpenSSL (no-op) . << >> . CERTHOST hostname certificate name certverify forcessl SSL NSS . . OpenSSL (no-op) . << >> . CERTVERIFY 0 | 1 SSL upsmon . upsd . (man-in-the-middle) . SSL upsd SSL . NSS SSL CERTHOST . FORCESSL 0 | 1 SSL upsd . CERTVERIFY 1 . upsd SSL upsmon SSL . NSS SSL CERTHOST . DEBUG_MIN INTEGER upsmon . -D (verbosity) . reload DEBUG_MIN NUMBER ( / ). DEBUG_MIN CLI ( ) . (SEE ALSO) upsmon(8), upsd(8), nutupsdrv(8). (Internet resources): NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5 Network UPS Tools 2.8.5 06/21/2026 UPSMON.CONF(5)