Role NUT Client

Role: NUT Client

Configures Network UPS Tools (NUT) in client mode to monitor the UPS via a NUT server running elsewhere on the network.

What It Does

1. Installs nut-client
2. Configures /etc/nut/nut.conf with MODE=netclient
3. Configures /etc/nut/upsmon.conf with the UPS monitor line
4. Starts and enables the nut-client service

Architecture

flowchart LR
    UPS[UPS] --> Server[NUT Server<br/>primary/master]
    Server --> Client[NUT Client<br/>NAS<br/>secondary/slave]

Loading

The NAS runs as a secondary NUT client. It monitors the UPS state via the primary NUT server (running on another device — in my case, the Proxmox server connected to the UPS via USB). When the UPS signals low battery, the NAS can initiate a safe shutdown.

Configuration

Key variables from group_vars:

Variable	Default	Purpose
nut_client_ups	dynamix	UPS name as defined on the NUT server
nut_client_server	10.1.1.3	IP of the NUT server
nut_client_type	secondary	Client type (secondary = safe shutdown on low battery)
nut_client_user	(from KeyVault)	NUT authentication user
nut_client_password	(from KeyVault)	NUT authentication password

Handler

Restarts the nut-client service when configuration files change.

🔗 NUT documentation | upsmon.conf reference