summaryrefslogtreecommitdiff
path: root/nut/iron/nut.conf
diff options
context:
space:
mode:
Diffstat (limited to 'nut/iron/nut.conf')
-rw-r--r--nut/iron/nut.conf39
1 files changed, 39 insertions, 0 deletions
diff --git a/nut/iron/nut.conf b/nut/iron/nut.conf
new file mode 100644
index 0000000..341c56e
--- /dev/null
+++ b/nut/iron/nut.conf
@@ -0,0 +1,39 @@
+# Network UPS Tools: example nut.conf
+#
+##############################################################################
+# General section
+##############################################################################
+# The MODE determines which part of the NUT is to be started, and which
+# configuration files must be modified.
+#
+# This file try to standardize the various files being found in the field, like
+# /etc/default/nut on Debian based systems, /etc/sysconfig/ups on RedHat based
+# systems, ... Distribution's init script should source this file to see which
+# component(s) has to be started.
+#
+# The values of MODE can be:
+# - none: NUT is not configured, or use the Integrated Power Management, or use
+# some external system to startup NUT components. So nothing is to be started.
+# - standalone: This mode address a local only configuration, with 1 UPS
+# protecting the local system. This implies to start the 3 NUT layers (driver,
+# upsd and upsmon) and the matching configuration files. This mode can also
+# address UPS redundancy.
+# - netserver: same as for the standalone configuration, but also need
+# some more network access controls (firewall, tcp-wrappers) and possibly a
+# specific LISTEN directive in upsd.conf.
+# Since this MODE is opened to the network, a special care should be applied
+# to security concerns.
+# - netclient: this mode only requires upsmon.
+#
+# IMPORTANT NOTE:
+# This file is intended to be sourced by standard POSIX shell scripts (so
+# there is no guaranteed `export VAR=VAL` syntax) and by systemd on Linux.
+# You MUST NOT use spaces around the equal sign!
+
+MODE=netserver
+
+# Uncomment this to allow starting the service even if ups.conf has no device
+# sections at the moment. This environment variable overrides the built-in
+# "false" and an optional same-named default flag that can be set in upsd.conf:
+#ALLOW_NO_DEVICE=true
+#export ALLOW_NO_DEVICE