Sistema web de monitoramento de UPS baseado no Network UPS Tools (NUT), com status em tempo real, gráficos históricos, alertas e relatórios programados, implantável via Docker.
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
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
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
Conjunto de dashboards personalizados do Grafana para visualizar dados do TeslaMate sobre trajetos, carregamento, eficiência, saúde da bateria e quilometragem.
Uma distribuição do OpenTelemetry Collector com pipelines programáveis baseados em expressões para métricas, logs, traces e profiles, desenvolvida com foco na integração com Prometheus.
Software auto-hospedado que executa testes de velocidade da internet em horários programados e mantém os resultados pelo período de retenção configurado.
Um exporter do Prometheus que coleta dados da suíte *arr (Sonarr, Radarr, Lidarr etc.) para monitorar e visualizar a saúde e o desempenho desses serviços.
Cria e gerencia dashboards do Grafana e alertas pré-configurados para serviços e infraestruturas comuns, sem precisar escrever queries manualmente.