What is nut_webgui?

This tool provides a browser-based dashboard for Network UPS Tools, letting you watch UPS metrics from several servers at once. It refreshes data automatically and lets you run instant commands, change variables, or trigger a forced shutdown from the interface. A JSON API and WebSocket feed give programmatic access, while a /metrics endpoint serves Prometheus-compatible OpenMetrics output. Health and readiness probes help with container orchestration. The UI ships with over a dozen built-in themes, including several dark variants. Authentication uses a simple TOML file with per-user permissions for administrative actions, and API keys can be issued for scripted access. TLS can be enabled for the link to the NUT daemon. Deployment options cover Docker, Docker Compose, Kubernetes manifests, and a standalone binary installer for Linux and FreeBSD. The binary runs on x86-64, ARM64, 32-bit ARM, and RISC-V with a memory footprint around 32 MiB.

Should you self-host nut_webgui?

nut_webgui scores 50/100 on selfhost.directory (how scoring works) and ranks #61 of 104 in Monitoring & observability. It has 436 GitHub stars.

It shipped 13 stable releases in the past year. The latest, v0.10.5, came out on 23 October 2026. New versions land roughly every 3 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is grafana (90/100, 77 568 stars). It scores higher overall, so compare the two before you pick. See nut_webgui vs grafana side by side.

Features

API Keys
Basic authentication with permissions
Basic JSON API
Health and readiness probes
INSTCMD, SET VAR, FSD support
OpenMetrics/Prometheus Export
Path-based routing for reverse proxy
TLS support for NUT connections
UPS monitoring with auto-refresh
WebSocket Events API

How to install nut_webgui

Install nut_webgui with Docker

Docker or Podman

Environment variables

UPSD_ADDR, UPSD_USER, UPSD_PASS, POLL_FREQ, POLL_INTERVAL, LISTEN, PORT, LOG_LEVEL

docker run -p 9000:9000
-e UPSD_ADDR=10.0.0.1
-e UPSD_USER=test
-e UPSD_PASS=strongpass
ghcr.io/superioone/nut_webgui:latest

Also available from codeberg.org/superiorone/nut_webgui

Install nut_webgui with Docker Compose

Docker Compose

Environment variables

UPSD_ADDR, UPSD_PORT, UPSD_USER, UPSD_PASS, POLL_FREQ, POLL_INTERVAL, LISTEN, PORT, LOG_LEVEL, AUTH_USERS_FILE, CONFIG_FILE

version: "3.3" services: nutweb: image: codeberg.org/superiorone/nut_webgui:latest restart: always ports: - 80:9000 environment: POLL_FREQ: "60" POLL_INTERVAL: "5" UPSD_ADDR: "my-nut-srv" UPSD_PORT: "3493" UPSD_USER: "admin" UPSD_PASS: "test" LISTEN: "0.0.0.0" PORT: "9000" LOG_LEVEL: "debug" volumes: - config-data:/etc/nut_webgui

volumes: config-data:

Supports host network mode and Docker secrets

Install nut_webgui with Kubernetes

Kubernetes cluster

Environment variables

UPSD_ADDR, UPSD_PORT, POLL_FREQ, UPSD_USER, UPSD_PASS

apiVersion: apps/v1 kind: Deployment metadata: name: nutweb-deployment spec: replicas: 1 selector: matchLabels: app: nutweb-pod template: metadata: labels: app: nutweb-pod spec: containers: - name: nutweb image: codeberg.org/superiorone/nut_webgui:latest envFrom: - secretRef: name: nutweb-secret env: - name: UPSD_ADDR value: "192.128.0.1" - name: UPSD_PORT value: "3493" - name: POLL_FREQ value: "20" resources: limits: memory: "64Mi" requests: memory: "32Mi" ports: - containerPort: 9000 startupProbe: httpGet: path: /probes/readiness port: 9000 initialDelaySeconds: 5 failureThreshold: 15 periodSeconds: 10 livenessProbe: httpGet: path: /probes/health port: 9000 initialDelaySeconds: 5 failureThreshold: 3 periodSeconds: 30 readinessProbe: httpGet: path: /probes/readiness port: 9000 initialDelaySeconds: 5 failureThreshold: 3 periodSeconds: 30

Requires separate Service and Secret manifests

Install nut_webgui with Linux

Environment variables

NUTWG_TARGET, NUTWG_SERVER_KEY, INIT_SYSTEM, INTERACTIVE, MIRROR_NAME, INSTALL_PREFIX, DEBUG

curl -fL -o install.sh
"https://codeberg.org/SuperiorOne/nut_webgui/releases/download/latest/install.sh" less ./install.sh chmod +x ./install.sh sh ./install.sh

Install script creates config, service files, and man pages. Supports systemd, openrc, runit.

How to configure nut_webgui

NUTWG__AUTH__ALLOW_ANONYMOUS_METRICSfalseAllow access to the /metrics endpoint without an API key
Allow access to the /metrics endpoint without an API key
values: true, 1, false, 0
NUTWG__AUTH__USERS_FILEEnable authentication with the provided users.toml file
Enable authentication with the provided users.toml file
values: File path
NUTWG__CONFIG_FILECustom config.toml file path
Custom config.toml file path
values: File path
NUTWG__DEFAULT_THEMEbrowser preferenceWeb UI default theme
Web UI default theme
values: light, dark, abyss, autumn, business, black, corporate, dim, dracula, forest, kanagawa-dragon, night, nord, sunset, synthwave, tokyo-night
NUTWG__HTTP_SERVER__BASE_PATH/Override HTTP server base path
Override HTTP server base path
values: URI path
NUTWG__HTTP_SERVER__LISTEN0.0.0.0HTTP server listen address
HTTP server listen address
values: IPv4, IPv6
NUTWG__HTTP_SERVER__PORT9000HTTP server listen port (default 9000)
HTTP server listen port (default 9000)
values: 1-65535
NUTWG__HTTP_SERVER__WORKER_COUNTall available coresHTTP server worker count
HTTP server worker count
values: 1-usize::MAX
NUTWG__LOG_LEVELinfoLog level
Log level
values: error, warn, info, debug, trace
NUTWG__SERVER_KEYauto-generatedServer signing key used for signing session tokens
Server signing key used for signing session tokens
values: Text
NUTWG__UPSD__ADDRESSUPSD address
UPSD address
values: IPv6, IPv4, hostname
NUTWG__UPSD__PASSWORDUPSD password
UPSD password
values: Text
NUTWG__UPSD__POLL_FREQNon-critical UPS variables update frequency in seconds
Non-critical UPS variables update frequency in seconds
values: 1-u64::MAX
NUTWG__UPSD__POLL_INTERVALCritical UPS variables (ups.status) update interval in seconds
Critical UPS variables (ups.status) update interval in seconds
values: 1-u64::MAX
NUTWG__UPSD__PORT3493UPSD connection port
UPSD connection port
values: 1-65535
NUTWG__UPSD__TLS_MODEConfigures TLS communication between UPSD and the client
Configures TLS communication between UPSD and the client
values: strict, disable, skip
NUTWG__UPSD__USERNAMEUPSD username
UPSD username
values: Text