NAME

       hosts.conf - Access control for Network UPS Tools CGI programs

DESCRIPTION

       The CGI programs (upsset.cgi(8), upsstats.cgi(8), upsimage.cgi(8)) use this file to determine if they are
       allowed to talk to a host. This keeps random visitors from using your web server to annoy others by
       creating outgoing connections.

IMPORTANT NOTES

       •   Contents of this file should be pure ASCII (character codes not in range would be ignored with a
           warning message).

       •   This file does not contain passwords. Read-only monitoring in NUT is anonymous, and the upsset(8)
           program asks for credentials in the browser session when commanding a particular UPS (web-server
           should be secured, as reported to the program by upsset.conf(5) file).

DIRECTIVES

       MONITOR ups description
           The ups element is in the form upsname[@hostname[:port]].

           To allow connections to an UPS called "snoopy" on a system called "doghouse" that runs upsd on port
           7877, it would look like this:

               MONITOR snoopy@doghouse:7877 "Joe Cool"

           The description must be one element, so if it has spaces, then it must be wrapped with quotes as
           shown above. The default hostname is "localhost".

SEE ALSO

       upsset.cgi(8), upsstats.cgi(8), upsimage.cgi(8)

   Internet resources:
       The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.3/

Network UPS Tools 2.8.3                            07/08/2025                                      HOSTS.CONF(5)