---
name: "upsimage.cgi"
section: "8"
platform: "linux"
package: "nut"
version: "2.8.5-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/upsimage.cgi"
---

# upsimage.cgi(8)

Image-generating helper for upsstats.cgi

## NAME

upsimage.cgi - Image-generating helper for upsstats.cgi

## SYNOPSIS

**upsimage.cgi**

**Note**\

As a CGI program, this should be invoked through your web server. If you run it from the command line, it will either complain about unauthorized access or spew a PNG at you.

## DESCRIPTION

**upsimage.cgi** generates the graphical bars that make up the right side of the page generated by [**upsstats.cgi**(8)](/upsstats.cgi/8.md). These represent the current battery charge, utility voltage, and UPS load where available.

The images are in PNG format, and are created by linking to Boutell’s excellent *gd* library.

For details about configuring some popular web servers to run NUT CGI programs, please see the [**upsset.conf**(5)](/upsset.conf/5.md) page.

## ACCESS CONTROL

upsstats will only talk to [**upsd**(8)](/upsd/8.md) servers that have been defined in your [**hosts.conf**(5)](/hosts.conf/5.md). If it complains about "Access to that host is not authorized", check that file first.

## FILES

[**hosts.conf**(5)](/hosts.conf/5.md)

## SEE ALSO

[**upsd**(8)](/upsd/8.md), [**upsstats.cgi**(8)](/upsstats.cgi/8.md)

### 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