Skip to content

Instantly share code, notes, and snippets.

@jhelmink

jhelmink/Proxomox - NUT Client - Synology NAS.md

Forked from pae-id/Proxomox - NUT Client.md
Last active October 29, 2025 22:56
Show Gist options
  • Save jhelmink/ba54e11e6a1b9f448a4a9a5c4cb45b89 to your computer and use it in GitHub Desktop.
Save jhelmink/ba54e11e6a1b9f448a4a9a5c4cb45b89 to your computer and use it in GitHub Desktop.
Download ZIP
Proxomox - NUT Client.md
Raw
Proxomox - NUT Client - Synology NAS.md

Configuring Proxmox VE node as client for remote NUT server running on Synology NAS

Network UPS Tools User Manual

  • Use Shell on Proxmox Node to install NUT Client
apt-get install nut-client
  • Edit /etc/nut/nut.conf using vi
vi /etc/nut/nut.conf

Modify the last line

x to delete existing characters

i to insert characters. ESC to go back to command mode

MODE=netclient

:q! to quit without saving if you fuck it up

:wq to save and quit when you get it right

  • Edit /etc/nut/upsmon.conf using vi
vi /etc/nut/upsmon.conf

There won't be an existing line, look for the other MONITOR example comments and add after that.

MONITOR <system> <powervalue> <username> <password> ("master"|"slave")

<system> is [email protected]

monuser and secret are the default <username> <password> for a Synology NAS

<powervalue> is going to be 1 unless you have multiple UPS's

Since you're monitoring your NAS you are in slave mode

MONITOR [email protected] 1 monuser secret slave
  • Enable monitoring services to start up with the machine:
sudo systemctl enable nut-monitor
  • Start monitoring:
sudo systemctl start nut-monitor
  • Verify monitoring:
systemctl status nut-client
systemctl status nut-monitor
  • To check UPS status from your Proxmox Server upsc <name>@<address> for the remote UPS
upsc [email protected]

This will return a bunch of your UPS info if everything is working correctly

  • Confirm clients are connecting back on the Synology NAS:
upsc -c ups
@webysther
Copy link

webysther commented Sep 24, 2025 •
edited
Loading

There some possible optimizations in your script, this is mine I use for years:

# install only the client
apt install nut-client

# enable client mode
sed -i 's/^MODE=none$/MODE=netclient/' /etc/nut/nut.conf

echo "RUN_AS_USER root" | tee -a /etc/nut/upsmon.conf

# change the IP of your NAS (REMEMBER TO ALLOW THE PROXMOX ON SYNOLOGY FIREWALL AND UPS SERVER)
echo "MONITOR ups@<IP>:3493 1 monuser secret slave" | tee -a /etc/nut/upsmon.conf

# BONUS: Disable broadcast and keep only the syslog
echo "NOTIFYFLAG ONLINE SYSLOG" | tee -a /etc/nut/upsmon.conf
echo "NOTIFYFLAG ONBATT SYSLOG" | tee -a /etc/nut/upsmon.conf
echo "NOTIFYFLAG LOWBATT SYSLOG" | tee -a /etc/nut/upsmon.conf

systemctl restart nut-client
systemctl status nut-client
● nut-monitor.service - Network UPS Tools - power device monitor and shutdown controller
     Loaded: loaded (/lib/systemd/system/nut-monitor.service; enabled; preset: enabled)
     Active: active (running) since Wed 2025-09-24 09:40:34 CEST; 5s ago
   Main PID: 124400 (upsmon)
      Tasks: 2 (limit: 76809)
     Memory: 852.0K
        CPU: 3ms

UPS Server

image

Synology Firewall

image

@dbsanders
Copy link

Just a couple minor things - I just set this up today using your info, thanks!

  1. All you need to install is the nut-client package, not all of 'nut'. apt install nut-client.

  2. You say: <system> is [email protected]
    This actually needs to be ups@your.nas.ip.address - That's the name Synology NUT gives to your UPS: 'ups'.

  3. The nut-monitor and nut-client services are the same, one is a link to the other. You can just systemctl enable/start nut-monitor, no need to operate on both.

lrwxrwxrwx 1 root root  19 Jan 25  2023 nut-client.service -> nut-monitor.service
-rw-r--r-- 1 root root 961 Jan 25  2023 nut-monitor.service

@BhSimon
Copy link

BhSimon commented Sep 25, 2025

Okay, update. As noted about myself: "I feel like I am missing something obvious." I was.

The final command, upsc -c ups should be run on the server (such as Synology NAS). [facepalm] When you do this, you will see the IP addresses of the Proxmox nodes you have set up.

This means that I can confirm that this walkthrough works on Proxmox 9. Apologies for my misunderstanding, and thank you, @jhelmink, for this useful guide.

@jhelmink
Copy link
Author

Just a couple minor things

Thanks for the feedback, definitely simplifies things, I've made some updates as suggested.

Okay, update. As noted about myself: "I feel like I am missing something obvious." I was.

Glad you were able to get it sorted, I've made a note to make it clearer for the next person.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment