Repolode
Brandawg93

Brandawg93/PeaNUT

Un panel web ligero para supervisar dispositivos UPS gestionados por Network UPS Tools (NUT).

Estrellas
1,722
Forks
51
Issues abiertos
26
Último commit
hace 5 días

¿Qué es?

PeaNUT es un panel web que muestra el estado y las estadísticas en tiempo real de dispositivos UPS (sistemas de alimentación ininterrumpida) expuestos por un servidor NUT. Permite consultar varias unidades UPS, ejecutar comandos y cambiar ajustes modificables, además de acceder al servidor NUT desde una terminal.

Además del panel integrado, PeaNUT ofrece una API REST y un endpoint WebSocket, así como métricas de Prometheus e integración con InfluxDB v2 para Grafana. También incluye widgets para los paneles Homepage y Glance. La configuración se realiza principalmente desde la interfaz web, con la opción de usar un archivo YAML, y se ejecuta como contenedor Docker en linux/amd64 y linux/arm64 (Raspberry Pi 4 o posterior).

La autenticación es para un solo usuario y usa contraseñas cifradas con bcrypt. Se puede configurar automáticamente mediante variables de entorno o desactivar por completo.

Funciones clave

  • 01Supervisa varios dispositivos UPS de la red a través de NUT, con estado y estadísticas en tiempo real
  • 02Ejecuta comandos y modifica variables editables de los dispositivos UPS desde la interfaz
  • 03Ofrece una API REST y un endpoint WebSocket para integrarse con otras herramientas
  • 04Proporciona métricas de Prometheus y compatibilidad con InfluxDB v2 para paneles de Grafana
  • 05Incluye widgets para los paneles Homepage y Glance
  • 06Ofrece autenticación para un solo usuario con contraseñas cifradas con bcrypt

Casos de uso

  • Consultar desde el navegador la carga de la batería, la autonomía y el consumo de un UPS doméstico o de oficina
  • Incorporar métricas de UPS a una infraestructura de monitorización existente con Prometheus o Grafana
  • Mostrar el estado del UPS en una página de inicio autoalojada de Homepage o Glance
  • Ejecutarlo en una Raspberry Pi 4 u otro equipo arm64 cerca de un NAS o un rack de servidores

Inicio rápido

  1. 1

    Ejecuta el contenedor PeaNUT con Docker

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

    Abre el panel en tu navegador en localhost:8080

Antes de usarlo

  • Se requiere un servidor NUT con dispositivos UPS que supervisar.
  • A partir de la versión 5.17.0, Raspberry Pi 3 y anteriores (arm/v7) ya no son compatibles.

En colecciones

Temas

Preguntas frecuentes

¿Qué es PeaNUT?
Un panel web ligero para supervisar dispositivos UPS gestionados por Network UPS Tools (NUT). PeaNUT es un panel web que muestra el estado y las estadísticas en tiempo real de dispositivos UPS (sistemas de alimentación ininterrumpida) expuestos por un servidor NUT. Permite consultar varias unidades UPS, ejecutar comandos y cambiar ajustes modificables, además de acceder al servidor NUT desde una terminal.
¿PeaNUT es gratuito? ¿Qué licencia tiene?
PeaNUT es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿PeaNUT sigue mantenido?
Mantenimiento activo. El último commit de PeaNUT fue el 1 nov 2026.
¿Para qué puedo usar PeaNUT?
Consultar desde el navegador la carga de la batería, la autonomía y el consumo de un UPS doméstico o de oficina Incorporar métricas de UPS a una infraestructura de monitorización existente con Prometheus o Grafana Mostrar el estado del UPS en una página de inicio autoalojada de Homepage o Glance Ejecutarlo en una Raspberry Pi 4 u otro equipo arm64 cerca de un NAS o un rack de servidores
¿Cómo se instala PeaNUT?
Ejecuta el contenedor PeaNUT con Docker: docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut Abre el panel en tu navegador en localhost:8080
¿Dónde consigo PeaNUT?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Brandawg93/PeaNUT

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados