UPSSET.CGI(8)

✨ UPSSET.CGI(8) ✨

okay so bestie, welcome to upsset.cgi — part of the NUT Manual (that's Network UPS Tools, not the snack, though honestly both are iconic 💅). grab a strawberry 🍓 and let's get into it.

---

🌸 NAME 🌸

upsset.cgi — the web-based UPS administration program. yes, administration. from your browser. main character energy fr fr 👑

---

🦋 SYNOPSIS 🦋

upsset.cgi

Note — bestie, this is a CGI program, so it's meant to be invoked through your web server. if you run it straight from the command line it will literally just sit there 🧍 until you feed it input that looks like a POST request. it's giving "waiting for you to text back" 😭

---

💖 DESCRIPTION 💖

So upsset.cgi is a read-write NUT client, which means it lets you reach a whole bunch of administrative functions inside the UPS software right from your web browser. you can change settings and invoke instant commands where they're available. slay ✨

want the deets on configuring popular web servers to run NUT CGI programs? go read upsset.conf(5), it's all in there 🫶

---

🎀 CHANGING SETTINGS 🎀

Some UPS hardware lets you change certain variables to other values. to see what's on offer: pick a UPS from the chooser, select "settings", then hit "View" to refresh the page. yes, you have to actually click View. it's not psychic 💀

You should see a list of items with the descriptions chillin' on the left side and the possible options or input spaces on the right. after you change something, be sure to "Save changes" to actually update the values in your UPS. don't forget. don't. 🫠

If your UPS doesn't support any read/write variables, there will be nothing to do on this page — it's giving empty group chat 🦋

ngl, you can also set values in read/write variables from the command line with upsrw(8) if that's more your vibe.

---

🌈 INSTANT COMMANDS 🌈

Some UPS hardware also has provisions for performing certain actions at the user's command. we're talking battery tests, battery calibration, front panel tests (beep!) and more 🔥 to get into this section, do the same as above, but pick "Commands" as the function.

If your UPS supports any instant commands, they'll be listed in a chooser widget. pick the one you like and hit "Issue command" to make it happen. periodt 💅

Note — some dangerous commands like "Turn off load" may not happen right away. this is a feature, not a bug. no cap. 🚨

The apcsmart(8) driver and some others require that you send this command twice within a short window in order to make it happen. why? to keep you from accidentally killing your systems by picking the wrong one 🙈 honestly, thank you apcsmart, you're a real one.

So to actually turn off the load, you have to send the command once, then send it again after 3 seconds elapse but before 15 seconds pass. if you do it too quickly or too slowly, you have to wait at least 3 seconds but not 15 seconds again. it's a whole rhythm game bestie, timing is everything ⏱️

You can also invoke instant commands from the command line with upscmd(8).

---

🧚 ACCESS CONTROL 🧚

It sends commands and settings via the server upsd(8) to your driver, which manages the hardware for you. so you must use credentials defined in the upsd.users(5) file on that data server, with appropriate permissions. no perms, no power moves 💜

upsset will only talk to upsd(8) servers that have been defined in your hosts.conf(5). if it starts complaining about "Access to that host is not authorized", check your hosts.conf first. it's always the config file, bestie, it's always the config file 😭

---

🔥 SECURITY 🔥

upsset will not run until you convince it that your CGI directory has been secured. why so strict? because of the possibility of someone using upsset to try password combinations against your upsd(8) server. like, brute-forcing your UPS. rude. 💀

See the example upsset.conf file for more info on how you do this. the short explanation is — if you can't lock it down, don't try to run it. periodt. 🔐

---

🍓 FILES 🍓

• hosts.conf(5)
• upsset.conf(5)

---

⭐ SEE ALSO ⭐

🌐 Internet resources:

The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/

---

and that's the whole page, bestie 🎀 this was Network UPS Tools 2.8.5, dated 10/07/2026, and honestly? iconic. go secure that CGI directory, mwah 💖👑✨