PeaNUT

PeaNUT is a web-based, tiny dashboard application for monitoring Uninterruptible Power Supplies (UPS).

  • Backup
  • Home Automation
  • Monitoring & Logging
  • Other
  • Productivity
  • Tools & Utilities
PeaNUT is a web-based, tiny dashboard application for monitoring Uninterruptible Power Supplies (UPS). It provides a user-friendly interface for real-time status, battery life, and power outage notifications to ensure system protection. It supports various UPS models, offers mobile-friendly access, and deploys via Docker.

Platform availability

Available on 5 of 10 platforms

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

79/100 Good

Maintained
97last commit 33 days ago
Popular
651,718 GitHub stars
Easy to install
755 install platforms, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM
Security check
94no serious findings, 1 minor, CI, tests

Availability: platform listings confirmed today, links checked 7 days ago

GitHub stars
1,718
Open issues
24
Last commit
2026-10-19
Latest release
v6.1.2
License
Apache-2.0
Activity
rising

Checked 22 days ago - source: GitHub (Brandawg93/PeaNUT)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 1 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set your PeaNUT web login first Set WEB_USERNAME and WEB_PASSWORD (the username and password for the PeaNUT website) in your Helm values or Docker Compose environment before starting. Without them, you may not be able to sign in after the app is running. source
  • Add your NUT server details Set NUT_HOST and NUT_PORT plus the NUT USERNAME and PASSWORD, or use NUT_SERVERS if you have multiple UPS servers. NUT is the backend that reads your UPS; if PeaNUT can't reach it, the page may load but it cannot show battery or power status. source
  • Expose the web port 8080 Map the container's web port 8080 to your host, for example ports: 8080:8080 in Docker Compose, or use an ingress/reverse proxy in Kubernetes. If this port is not reachable, your browser cannot open the PeaNUT login page. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can PeaNUT run behind a reverse proxy on a subpath?

Yes. Set the BASE_PATH environment variable to the path that the reverse proxy forwards to PeaNUT.

Why would PeaNUT settings made in the web UI not persist after a restart?

The container runs as UID/GID 1000:1000, so the host directory mounted at /config must be writable by that user. You can fix EACCES errors by chowning the config directory to 1000:1000 or setting the container user to match the host directory owner, and PUID/PGID environment variables are not supported.

How is the first PeaNUT user created?

Set WEB_USERNAME and WEB_PASSWORD before the first start, and they are used for auto-creation. You can also set AUTH_DISABLED=true to disable authentication.

Can PeaNUT monitor more than one NUT server?

Yes, update 2 added multi-server support.

Can PeaNUT export UPS metrics to InfluxDB or Prometheus?

Yes, it supports InfluxDB v2 integration for monitoring via Grafana and Prometheus support for monitoring and alerting.

Answers sourced from github.com, www.redditmedia.com

Community

Collected 53 days ago - public community threads