unifi-shutd/README.md

unifi-shutd

This is a simple daemon that monitors the in-built NUT server on a Ubiquiti UniFi UPS and safely shuts down the active system when the UPS switches to battery power (on AC loss).

Usage

1. Install the unifi-shutd daemon to /usr/local/bin/unifi-shutd
2. Generate the config file using unifi-shutd config (run as root)
3. Install the service file for your init system
   • OpenRC: Save services/openrc to /etc/init.d/unifi-shutd
   • systemd: Not yet implemented (feel free to contribute; I just haven't bothered because all my baremetal servers are based on Alpine Linux)
4. Enable and start the service
5. Test disconnecting your UPS from AC and ensure the service properly shuts down your server