UPSIMAGE.CGI(8)

💖 UPSIMAGE.CGI(8) — the NUT Manual, but make it cute 💖

okay bestie, welcome to the upsimage.cgi page, part of the Network UPS Tools manual. it's a lil helper program and honestly it's iconic. let's get into it 🎀

---

✨ NAME ✨

upsimage.cgi — the image-generating helper for upsstats.cgi 🖼️✨

---

🌸 SYNOPSIS 🌸

upsimage.cgi

note, bestie 📌 — this is a CGI program, so the way you're supposed to run it is through your web server. if you try to run it straight from the command line, it's gonna do one of two things: either complain about unauthorized access, or just straight up spew a PNG at you. no in-between. 😭

---

💅 DESCRIPTION 💅

upsimage.cgi is the one that generates the graphical bars, okay? those are the bars on the right side of the page that upsstats.cgi(8) puts together. it's giving very much "supporting cast, but make it essential." 👑

and what do those bars actually show? they represent the current battery charge, the utility voltage, and the UPS load — where available, obviously, no cap. 🔋⚡

the images come out in PNG format, and they get made by linking to Boutell's excellent gd library. we stan. 💖

if you wanna know the deets on configuring some popular web servers to run NUT CGI programs, go peek at the upsset.conf(5) page. it's all in there, iykyk. 📖

---

🔒 ACCESS CONTROL 🔒

here's the tea ☕ — upsstats will only talk to upsd(8) servers that have been defined in your hosts.conf(5). that's the guest list and there's no plus-ones.

so if it starts complaining about "Access to that host is not authorized", do not panic, just go check that file first. literally that file. first. 🙈

---

🗂️ FILES 🗂️

• hosts.conf(5)

---

👀 SEE ALSO 👀

• upsd(8)
• upsstats.cgi(8)

🌈 Internet resources:

• The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/ 🫶
• The gd home page: http://libgd.bitbucket.org 🎨

---

and that's the whole page, bestie!! this was Network UPS Tools 2.8.5, dated 10/07/2026, and yes the manual page is literally called UPSIMAGE.CGI(8). slay, go configure your web server, you've got this 💜🦋✨