Our take
- 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.
Stars
1,737Forks
54Change 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.