Repolode
Brandawg93

Brandawg93/PeaNUT

Dashboard web leve para monitorar dispositivos UPS gerenciados pelo Network UPS Tools (NUT).

Estrelas
1,728
Forks
51
Issues abertas
26
Último commit
há 6 dias

O que é?

PeaNUT é um dashboard web que exibe o status e as estatísticas em tempo real de dispositivos UPS (no-breaks) disponibilizados por um servidor NUT. Ele permite visualizar várias unidades UPS, executar comandos e alterar configurações graváveis nelas, além de acessar o servidor NUT pelo terminal.

Além do dashboard integrado, o PeaNUT oferece uma REST API e um endpoint WebSocket, além de métricas do Prometheus e integração com o InfluxDB v2 para o Grafana. Também disponibiliza widgets para os dashboards Homepage e Glance. A configuração é feita principalmente pela interface web, com a opção de usar um arquivo YAML, e o projeto roda em um container Docker em linux/amd64 e linux/arm64 (Raspberry Pi 4 ou mais recente).

A autenticação é para um único usuário, com senhas com hash bcrypt, e pode ser configurada automaticamente por variáveis de ambiente ou totalmente desativada.

Recursos principais

  • 01Monitore vários dispositivos UPS na rede por meio do NUT, com status e estatísticas em tempo real
  • 02Execute comandos e altere variáveis graváveis dos dispositivos UPS pela interface
  • 03REST API e endpoint WebSocket para integração com outras ferramentas
  • 04Métricas do Prometheus e suporte ao InfluxDB v2 para dashboards do Grafana
  • 05Widgets para os dashboards Homepage e Glance
  • 06Autenticação para um único usuário com senhas com hash bcrypt

Casos de uso

  • Consultar pelo navegador a carga da bateria, o tempo de autonomia e a carga de um UPS doméstico ou do escritório
  • Enviar métricas do UPS para uma infraestrutura de monitoramento existente com Prometheus ou Grafana
  • Exibir o status do UPS em uma página inicial self-hosted do Homepage ou do Glance
  • Executar em um Raspberry Pi 4 ou outro host arm64 próximo a um NAS ou rack de servidores

Início rápido

  1. 1

    Execute o contêiner PeaNUT com o Docker

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

    Abra o painel no navegador acessando localhost:8080

Antes de usar

  • É necessário ter um servidor NUT com dispositivos UPS para monitorar.
  • A partir da versão 5.17.0, o Raspberry Pi 3 e versões anteriores (arm/v7) não são mais compatíveis.

Em coleções

Tópicos

Perguntas frequentes

O que é PeaNUT?
Dashboard web leve para monitorar dispositivos UPS gerenciados pelo Network UPS Tools (NUT). PeaNUT é um dashboard web que exibe o status e as estatísticas em tempo real de dispositivos UPS (no-breaks) disponibilizados por um servidor NUT. Ele permite visualizar várias unidades UPS, executar comandos e alterar configurações graváveis nelas, além de acessar o servidor NUT pelo terminal.
PeaNUT é gratuito? Qual é a licença?
PeaNUT é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
PeaNUT ainda é mantido?
Manutenção ativa. O último commit de PeaNUT foi em 1 de nov. de 2026.
Para que posso usar PeaNUT?
Consultar pelo navegador a carga da bateria, o tempo de autonomia e a carga de um UPS doméstico ou do escritório Enviar métricas do UPS para uma infraestrutura de monitoramento existente com Prometheus ou Grafana Exibir o status do UPS em uma página inicial self-hosted do Homepage ou do Glance Executar em um Raspberry Pi 4 ou outro host arm64 próximo a um NAS ou rack de servidores
Como instalar PeaNUT?
Execute o contêiner PeaNUT com o Docker: docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut Abra o painel no navegador acessando localhost:8080
Onde consigo PeaNUT?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Brandawg93/PeaNUT

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados