Brandawg93

PeaNUT: Monitor Network UPS Tools Devices

PeaNUT is a self-hosted dashboard for monitoring UPS devices managed by Network UPS Tools. It brings device status and statistics into a web interface, with APIs and integrations for monitoring and home dashboards.

TypeScriptApache-2.0Next.jsDashboardMonitoring
View on GitHub Compare
Stars
1.7k
Forks
48
Stars, last 30 days
+34

Our take

Health score

41/100

How it is scored
Activity
62
Community
34
Issues
21
Pull requests
46

+34 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

1,737

Forks

54

Change since Nov 15, 2026: 0 stars·0 forks

Overview

PeaNUT provides a web dashboard for UPS devices exposed by a Network UPS Tools (NUT) server. It helps home-lab operators and administrators check device status and statistics without relying only on direct NUT server access.

It supports multiple UPS devices, configuration through the interface or a YAML file, and access to NUT data through an API. It is a good fit when you already run NUT and want a visual dashboard or data for other monitoring tools.

Key Features

  • Displays live status and statistics for multiple NUT-managed UPS devices.
  • Offers a customizable dashboard layout and widgets.
  • Allows supported UPS commands and settings to be managed through the interface.
  • Provides a REST API and WebSocket endpoint for accessing NUT data.
  • Exposes Prometheus metrics and supports InfluxDB v2 integration.
  • Integrates with Homepage and can provide data to Glance dashboards.
  • Supports UI-based configuration and manual YAML configuration.

Use Cases

  • Home-lab users can monitor UPS battery state and status from a browser.
  • Administrators managing several networked UPS devices can view them together and run available device commands.
  • Monitoring teams can collect UPS data through Prometheus or InfluxDB integrations.
  • Homepage or Glance users can add UPS status to an existing self-hosted dashboard.
  • Developers can use the API to incorporate UPS information into other tools.

Getting Started

Run PeaNUT in Docker with a persistent configuration directory:

docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped \
  --env WEB_PORT=8080 brandawg93/peanut

The container's /config directory must be writable by its runtime user for settings saved through the UI to persist. See the README for configuration, authentication, reverse proxy, and integration details.

Considerations

  • PeaNUT is a dashboard and interface for NUT, so it requires an available NUT server and configured UPS devices.
  • The documented container platforms are Linux amd64 and arm64. Raspberry Pi 3 and older arm/v7 devices are no longer supported from version 5.17.0.
  • Authentication can be disabled with an environment variable. If exposed beyond a trusted network, review authentication and deployment settings carefully.
  • The project provides a single-user authentication system, rather than multi-user account management.

Found this useful?

Share it with someone who would like PeaNUT.