Question 1

What is PeaNUT?

Accepted Answer

PeaNUT is a clean, modern web dashboard for Network UPS Tools (NUT), the standard Linux system for monitoring uninterruptible power supplies. It shows your UPS's battery charge, load, voltage, and estimated runtime in a readable browser page, far more legibly than NUT's own dated tools. Importantly, it is a dashboard, not a driver — it reads from an existing NUT server. This install runs it on port 8314.

Question 2

Do I need NUT already set up?

Accepted Answer

Yes — this is the key requirement. PeaNUT does not talk to your UPS hardware directly; it connects as a client to a NUT server (the upsd daemon), which handles the UPS over USB or serial and exposes readings on the network, conventionally on port 3493. So you need a working NUT setup — the UPS defined in ups.conf and upsd running — for PeaNUT to have anything to display. NUT is the prerequisite PeaNUT depends on.

Question 3

Which port does it use?

Accepted Answer

PeaNUT's dashboard is on host port 8314, mapped from the container's internal port 8080. Separately, the NUT server it connects to conventionally listens on port 3493. Keep both on a trusted network: put PeaNUT's web UI behind a reverse proxy with TLS for remote access, and let only authorised clients reach NUT's 3493, protected by NUT credentials and firewalled from untrusted networks.

Question 4

Can PeaNUT talk to my UPS directly?

Accepted Answer

No — and this is the most common misunderstanding. PeaNUT is only a visualisation layer. The component that actually communicates with the UPS hardware over USB or serial, understands its protocol, and can trigger a safe shutdown is the NUT server. PeaNUT connects to that server over the network and displays what it reports. So the UPS must be managed by NUT first; PeaNUT then makes those readings pleasant to look at.

Question 5

Where can the NUT server run?

Accepted Answer

Anywhere PeaNUT can reach it over the network on port 3493. It might be on the same machine as PeaNUT, on the box the UPS is physically plugged into, or on a NAS such as a Synology that runs NUT. You configure PeaNUT with that server's host, port, and credentials. If NUT is on a different machine, PeaNUT just needs network access to that host's 3493, which you set in the dashboard's connection configuration.

Port	Purpose
8314	PeaNUT web dashboard (mapped from container port 8080)
3493	NUT server (upsd) — the NUT instance PeaNUT connects to, on your network

🔋 Setup PeaNUT — Web Dashboard for Your UPS (Network UPS Tools)

📦 Resources & Setup Scripts

Quick Install:

Tutorial Steps

1 Download the Script

2 Make it Executable

3 Run the Installer

4 Point PeaNUT at Your NUT Server

Ports Used

Overview

Why Use It

When You Need It

Who Should Use It

Real Use Cases

Main Features

How to Use After Installation

Security Best Practices

Ports and Firewall Notes

Backup and Maintenance

Common Mistakes

Troubleshooting

Alternatives

When Not to Use It

PrismaTechWork Professional Help

Frequently Asked Questions