I didn't know about the Kreaweb guide until now. I followed the Techno Tim video for set up in my Proxmox cluster and it worked with some differences listed below as I'm using an old APC UPS which communicates over serial instead of USB. I had a quick look of the Kreaweb guide, and I believe it doesn't differ too much from the Techno Tim one. No you don't need to setup an LXC container. As listed in the docs, "We use a seperate LXC container because, for security reasons, we don NOT want to install a webserver directly onto our Proxmox PVE." It is just for the Apache server for presenting the UPS statistics in a graphical user interface. I don't use the apache server anyway, I'm using a docker container called PeaNUT that can connect to the NUT server and present the stats in a webpage. To put it in other words (which the Kreaweb guide didn't explain in depth), nut-server is used to communicate with the UPS and allow nut-clients to connect to them to get the latest status nut-client is used to listen to nut-server and run timers/scripts depending on the status of the server (e.g. shutting down the computer) For the Proxmox server that is connected to the UPS, you need to install both nut-server and nut-client, nut-server for communicating with the UPS and sharing it out and nut-client for getting the UPS status on the command line or shutting down itself For the "clients", just install nut-client directly on them so that it can monitor the server and shut down themselves. If you want a web GUI for presenting the NUT status and stats, run a separate LXC container with nut-client and apache as mentioned in the Kreaweb guide, or run a separate WebNUT or PeaNUT docker container. My major differences with the guides: One - Run the NUT server as root As I'm using an APC UPS with serial connection, I have to run the NUT server as root as the serial device /dev/ttyS0 is owned by root. Otherwise, the NUT server can't use the serial port. Example ups.conf: user = root pollinterval = 1 maxretry = 3 [apc-sc420] driver = apcsmart port = /dev/ttyS0 cable = 940-0024C desc = "APC Smart UPS 420VA SC420I" Two - upssched In the TechnoTim guide, the upssched.conf has the configuration AT ONBATT * START-TIMER earlyshutdown 30. This means that the computer will shutdown 30 seconds after the UPS is on battery, which is definitely too short and I changed it to a longer value (e.g. 1800 for 30 minutes). Also, most people would want the shutdown timer to cancel when the UPS comes back on line power, therefore, I have to add a line AT ONLINE * CANCEL-TIMER earlyshutdown there. In the Kreaweb guide, the early shutdown timer is removed altogether (you can see it has been crossed out). That means the computer will only shutdown when the UPS battery level is critical. If it is what you want then it is ok. But I would like to have Proxmox shutdown before reaching critical as shutting down all VMs then shutting down itself still consumes some time and power. Answer from kingman1234 on reddit.com
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Install NUT directly on Proxmox VE and control guests from here | Proxmox Support Forum
January 14, 2024 - Click to expand... What actually happens when the system detects the server is running on battery? Which scripts are executed? How is the PVE server supposed to shut down properly? I tested the software and it detects nicely the UPS. Much simpler as the cumbersome NUT or APCUPSD.
🌐
Reddit
reddit.com › r/proxmox › any up-to-date guides for setting up proxmox as a ups nut server?
r/Proxmox on Reddit: Any up-to-date guides for setting up Proxmox as a UPS NUT server?
January 29, 2025 -

Hey,

I would like to set up my Proxmox server as a UPS NUT server and connect several of my network devices as NUT clients. I found that most people refer to the Techno Tim video and the Kreaweb guide, however these guides seem to be a couple of years old + from what I've seen they differ in certain steps. I guess that coupled with the official documentation they are still good enough to get everything to work but I was wondering whether there are also other/newer guides I could check out.

On a side note, is it really necessary to set up a LXC container as a NUT client (as described in the Kreaweb guide) so that Proxmox basically monitors itself? What is the point? Is it just for the stats or is the client necessary for shutting down Proxmox itself?

Thanks!

Top answer
1 of 8
13
I didn't know about the Kreaweb guide until now. I followed the Techno Tim video for set up in my Proxmox cluster and it worked with some differences listed below as I'm using an old APC UPS which communicates over serial instead of USB. I had a quick look of the Kreaweb guide, and I believe it doesn't differ too much from the Techno Tim one. No you don't need to setup an LXC container. As listed in the docs, "We use a seperate LXC container because, for security reasons, we don NOT want to install a webserver directly onto our Proxmox PVE." It is just for the Apache server for presenting the UPS statistics in a graphical user interface. I don't use the apache server anyway, I'm using a docker container called PeaNUT that can connect to the NUT server and present the stats in a webpage. To put it in other words (which the Kreaweb guide didn't explain in depth), nut-server is used to communicate with the UPS and allow nut-clients to connect to them to get the latest status nut-client is used to listen to nut-server and run timers/scripts depending on the status of the server (e.g. shutting down the computer) For the Proxmox server that is connected to the UPS, you need to install both nut-server and nut-client, nut-server for communicating with the UPS and sharing it out and nut-client for getting the UPS status on the command line or shutting down itself For the "clients", just install nut-client directly on them so that it can monitor the server and shut down themselves. If you want a web GUI for presenting the NUT status and stats, run a separate LXC container with nut-client and apache as mentioned in the Kreaweb guide, or run a separate WebNUT or PeaNUT docker container. My major differences with the guides: One - Run the NUT server as root As I'm using an APC UPS with serial connection, I have to run the NUT server as root as the serial device /dev/ttyS0 is owned by root. Otherwise, the NUT server can't use the serial port. Example ups.conf: user = root pollinterval = 1 maxretry = 3 [apc-sc420] driver = apcsmart port = /dev/ttyS0 cable = 940-0024C desc = "APC Smart UPS 420VA SC420I" Two - upssched In the TechnoTim guide, the upssched.conf has the configuration AT ONBATT * START-TIMER earlyshutdown 30. This means that the computer will shutdown 30 seconds after the UPS is on battery, which is definitely too short and I changed it to a longer value (e.g. 1800 for 30 minutes). Also, most people would want the shutdown timer to cancel when the UPS comes back on line power, therefore, I have to add a line AT ONLINE * CANCEL-TIMER earlyshutdown there. In the Kreaweb guide, the early shutdown timer is removed altogether (you can see it has been crossed out). That means the computer will only shutdown when the UPS battery level is critical. If it is what you want then it is ok. But I would like to have Proxmox shutdown before reaching critical as shutting down all VMs then shutting down itself still consumes some time and power.
2 of 8
9
don't think anything has really changed. The technotim guide didn't work for me but the kreaweb did under 7.x and the same configuration is still working under 8.3.3
Discussions

UPS NUT and VMs | Proxmox Support Forum
I have installed NUT as a client (of a Synology) into Proxmox VE. It looks like it works fine - upsc tells me good things, and systemctl status nut-client shows the daemon active and running. Question: If power goes down, will PVE send shutdown commands to active VMs, or do I have to install... More on forum.proxmox.com
🌐 forum.proxmox.com
August 22, 2025
Network UPS Connect (NOT HOST) | Proxmox Support Forum
I've been searching and most of what I've found suggests installing NUT, connecting the UPS to the Proxmox server by USB and using that as the UPS host. This is not what I want to do. I have an existing UPS (APC) with a network card and have several other servers running off it (it's big) that... More on forum.proxmox.com
🌐 forum.proxmox.com
January 31, 2025
Config for Network UPS Tool (NUT) for Prolink | Proxmox Support Forum
I recently bought a Prolink PRO1501SFCU UPS for my Proxmox server. I watched Techno Tim's YouTube video on how to setup NUT but it doesn't seem to work for me. What I've done: 1. created a Proxmox debian turnkey core Linux container (unprivileged container = no; nesting = 1) 2. Installed nut... More on forum.proxmox.com
🌐 forum.proxmox.com
June 19, 2023
Proxmox and UPS best practice | Proxmox Support Forum
Broadcast message from root@dino ... on UPS SNMP web pro... ... @mircolino Oh hey there! I was gonna suggest that you of course can try sandboxing NUT, if it installs too many packages for you - but hey, now apcupsd works for you anyway. I'm glad it worked! ... Best regards, Max Do you already have a Commercial Support Subscription? - If not, Buy now and read the documentation ... I have a problem with configuration of NUT. NUT server is a Synology DS918+. Proxmox host is the ... More on forum.proxmox.com
🌐 forum.proxmox.com
February 24, 2023
🌐
KREAWEB
kreaweb.be › diy-home-server-2021-software-proxmox-ups
DIY HOME SERVER 2021 - Software - PROXMOX - NUT UPS Monitoring | KREAWEB
February 1, 2025 - Be sure PIPEFN and LOCKFN point to a folder that esists, I’ve seen it point to /etc/nut/upssched/ instead of /etc/nut/. If it does, create the folder or update these variables. mkdir /etc/nut/upssched/ ... earlyshutdown) logger -t upssched-cmd "UPS on battery too long, early shutdown" /usr/sbin/upsmon -c fsd ;; shutdowncritical) logger -t upssched-cmd "UPS on battery critical, forced shutdown" /usr/sbin/upsmon -c fsd ;; upsgone) logger -t upssched-cmd "UPS has been gone too long, can't reach" ;; *) logger -t upssched-cmd "Unrecognized command: $1" ;; esac ... Now reboot your Proxmox server.
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
UPS NUT and VMs | Proxmox Support Forum
August 22, 2025 - On the PVE host I have a VM with Home Assistant which has Nut client configured (Nut integration). With this I can monitor the UPS/POWER status & have automations configured to take applicable/desired actions, the primary one being a Shutdown command sent (by SSH / API - see here) to the PVE host.
🌐
Unifi Controller
asokolsky.github.io › proxmox › nut.html
Configuring NUT with ProxMox | Notes to Self
MINSUPPLIES 1 SHUTDOWNCMD "/sbin/shutdown -h +0" POLLFREQ 5 POLLFREQALERT 5 HOSTSYNC 15 DEADTIME 15 POWERDOWNFLAG /etc/killpower RBWARNTIME 43200 NOCOMMWARNTIME 300 FINALDELAY 5 MONITOR theUPS@localhost 1 upsmonitor PASSWORD master ... root@fuji:/etc/nut# upsc theUPS Init SSL without certificate database battery.charge: 100 battery.charge.low: 10 battery.charge.warning: 50 battery.date: 2001/09/25 battery.mfr.date: 2017/05/31 battery.runtime: 3036 battery.runtime.low: 120 battery.type: PbAc battery.voltage: 27.3 battery.voltage.nominal: 24.0 device.mfr: American Power Conversion device.model:
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Network UPS Connect (NOT HOST) | Proxmox Support Forum
January 31, 2025 - AFAICT this should absolutely be possible through the NUT server/client setup. Let me start off by saying, I do not have a NW connected UPS, but rather a USB one (probably more common, as most web searches will show, & you have already alluded to that in your OP). I connected mine to the Proxmox host via USB, setup a NUT server on the host & other clients can easily monitor that, & take the appropriate actions on their side should they need to.
Find elsewhere
🌐
GitHub
gist.github.com › jhelmink › ba54e11e6a1b9f448a4a9a5c4cb45b89
Proxomox - NUT Client - Synology NAS.md
Connection refused might mean that your Proxmox server is just unable to connect with your NAS on your network, you could try to ping the NAS from Proxmox to ensure they can see each other on the network. They can. If I do upsc ups@192.168.1.32, I get a response. I feel like I am missing something obvious. ... # 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 "MONIT
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Config for Network UPS Tool (NUT) for Prolink | Proxmox Support Forum
June 19, 2023 - Update: I have finally successfully got the Prolink PRO1501SFCU running with NUT. The process and configuration is as below. 1. Ensure the USB cable from the UPS is connected to the Proxmox server 2. SSH into the Proxmox server or open it's shell terminal; we will be configuring this as the NUT server.
🌐
The Smarthome Book
thesmarthomebook.com › 2022 › september › 2 › set up & monitor your ups: proxmox & home-assistant
Set up & Monitor your UPS: Proxmox & Home-Assistant | The Smarthome Book
September 2, 2022 - Now we want to set up monitoring. I chose to install two ways to monitor. One in Home-Assistant and the other in docker. I wanted more than one option as they’re both on different machines. Let’s deal with Docker/Portainer first. I wrote a post here about running a docker stack in Portainer on Proxmox here if you’re interested. Portainer> Stacks > Add Stack (or via docker compose if more comfortable) ... version: “3.1” services: nut: image: teknologist/webnut container_name: webnut environment: – UPS_HOST=your.nut.server.ip – UPS_PORT=3493 – UPS_USER=upsadmin – UPS_PASSWORD=password.you.created.already restart: unless-stopped ports: – 6543:6543
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Proxmox and UPS best practice | Proxmox Support Forum
February 24, 2023 - ... Best regards, Max Do you already have a Commercial Support Subscription? - If not, Buy now and read the documentation ... I have a problem with configuration of NUT. NUT server is a Synology DS918+. Proxmox host is the NUT client.
🌐
HardTechnology Blog
blog.hardtechnology.net › post › proxmox-nut
Configure Proxmox for Automatic Shutdown with your SNMP UPS with nut - HardTechnology Blog
November 2, 2025 - Proxmox doesn’t have a built in method to trigger safe shutdown from a UPS (Uninteruptable Power Supply). In this blog we install and configure nut (Network UPS Tools) to shutdown the proxmox server in the event of a power failure.
🌐
GitHub
github.com › steven-geo › proxmox-nut
GitHub - steven-geo/proxmox-nut: Configure nut server for SNMP UPS Devices on Proxmox · GitHub
To perform this we configure nut (Network UPS Tools) to shutdown the Proxmox host, and thus all Guests based on their configuration and shutdown order set in Proxmox, ensuring a safe termination of services.
Author   steven-geo
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Network UPS Tools (NUT) as Ubuntu 22.04 LXC Container | Proxmox Support Forum
August 3, 2024 - # nut-scanner -U Scanning USB bus. [nutdev1] driver = "usbhid-ups" port = "auto" vendorid="051D" productid="0002" product = "Smart-UPS 1000 RM FW:618.3.I USB FW:1.5" serial = "AS0613230494" vendor = "American Power Conversion" bus = "001"
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
[SOLVED] - NUT Client configuration -> help needed for shutdown Proxmox host | Proxmox Support Forum
April 23, 2023 - So I went and yanked the plug on the UPS as a "test", and came back to the SSH console to my Proxmox server and saw these messages: ... root@prox2:/etc/nut# 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 2024-09-18 15:44:37 EDT; 13min ago Main PID: 2598402 (upsmon) Tasks: 2 (limit: 309110) Memory: 852.0K CPU: 45ms CGroup: /system.slice/nut-monitor.service ├─2598402 /lib/nut/upsmon -F └─2598403 /lib/nut/upsmon -F Sep 18 15:44:37 prox2 systemd[1]: Started nut-monitor.service - Network UPS Tools - power device monitor and shutdown controller.
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Proxmox as a NUT Server or Client? | Proxmox Support Forum
June 14, 2023 - All of the equipment is powered ... to pick one device as the NUT Server/Master (direct connected to UPS via USB) and everything else as Client/Slave and communicate via network. Which device should I make the Server? Any pro's or con's to Proxmox vs....
🌐
Proxmox
forum.proxmox.com › home › tags
nut | Proxmox Support Forum
I have installed nut on proxmox and managed to define the UPS. NUT successfuly executed a FSD, but not sure how to actually turn off the UPS, so an automatic poweron after power has returned would be executed.
🌐
GitHub
github.com › austinp0573 › proxmox-nut-setup
GitHub - austinp0573/proxmox-nut-setup: Proxmox NUT Setup provides step-by-step instructions for configuring Network UPS Tools (NUT) on a Proxmox host, supporting both USB and SNMP UPS connections. Includes troubleshooting tips, config examples, and guidance for Eaton Network-MS card admin reset via serial console. · GitHub
Proxmox NUT Setup provides step-by-step instructions for configuring Network UPS Tools (NUT) on a Proxmox host, supporting both USB and SNMP UPS connections. Includes troubleshooting tips, config examples, and guidance for Eaton Network-MS card ...
Author   austinp0573
🌐
TheTechCorner
blog.thetechcorner.sk › posts › UPS-proxmox-setup-homelab2-0
UPS proxmox setup (+ disable UPS beeping) [Homelab 2.0] | TheTechCorner
March 8, 2025 - Introduction In this post, I’ll walk you through a complete guide for integrating an UPS (Eaton 5E 850i) with your Proxmox setup using Network UPS tools aka NUT inside LXC container.
🌐
Proxmox
forum.proxmox.com › home › forums › proxmox virtual environment › proxmox ve: installation and configuration
Can't get NUT to shutdown Proxmox | Proxmox Support Forum
November 21, 2021 - With nut you got a server that monitors the UPS, provides statistics about the UPS for all clients and will send a shutdown command to all nut clients in case of an power outage. A nut client will just listen to a nut server.