O PeaNUT é uma solução leve e eficaz para monitorar seus no-breaks (UPS) conectados a um servidor NUT. Além disso, ele oferece uma interface web moderna, fácil de interpretar e muito mais prática do que usar o comando upsc via SSH. Dessa forma, você pode através do painel web monitorar UPS e acompanhar o status de bateria, carga e tensão de todos os seus UPSs em tempo real, diretamente do navegador.
Principalmente, o PeaNUT é ideal para quem já usa o NUT (Network UPS Tools) no Raspberry Pi ou em outro servidor. Consequentemente, ele funciona como um dashboard simples, mas poderoso, que pode ser acessado de qualquer dispositivo na rede.
Portanto, se você deseja transformar seu Pi em um painel de monitoramento de energia, este tutorial é para você. A seguir, você vai aprender a instalar o PeaNUT usando Docker, configurar a conexão com o servidor NUT e acessar a interface web.
Materiais Utilizados
Para concluir este projeto, você precisará dos seguintes itens:
![[20W 5V 4.0A] Fonte de alimentação Raspberry Pi 4, fonte de alime...](https://m.media-amazon.com/images/I/41Jua9JszML.jpg)
Materiais Opcionais
Além disso, certifique-se de que o servidor NUT já esteja instalado e configurado. Se ainda não tiver, confira nosso guia completo: Como configurar o NUT no Raspberry Pi.
Instalação e Configuração do PeaNUT no Raspberry Pi
Nas próximas etapas, vamos instalar o PeaNUT usando Docker, o que torna o processo simples, seguro e fácil de atualizar. Além disso, o PeaNUT é distribuído como um contêiner Docker compatível com ARM64 e ARMv7, funcionando em qualquer Raspberry Pi 2 ou mais recente.
Portanto, siga os passos abaixo com atenção para garantir uma instalação correta.
1. Atualize o sistema do Raspberry Pi
Antes de começar, é essencial garantir que seu sistema operacional esteja atualizado. Dessa forma, você evita conflitos de pacotes e garante a estabilidade do ambiente.
Além disso, execute os seguintes comandos no terminal:
sudo apt update
sudo apt upgrade -yConsequentemente, o sistema baixará as últimas atualizações de segurança e pacotes.
2. Instale o Docker no Raspberry Pi
O Docker é fundamental para executar o PeaNUT de forma isolada e segura. Por outro lado, se você ainda não tem o Docker instalado, siga nosso tutorial completo: Como instalar Docker no Raspberry Pi .
Para instalar rapidamente, use o script oficial:
curl -fsSL https://get.docker.com | shEm seguida, adicione o usuário pi ao grupo docker para evitar usar sudo em todos os comandos:
sudo usermod -aG docker pi🔗 Documentação oficial do Docker: docs.docker.com
3. Crie um diretório para o PeaNUT
Para manter a organização do sistema, vamos criar uma pasta dedicada ao projeto. Dessa forma, todos os arquivos do PeaNUT estarão centralizados.
Execute o comando abaixo:
sudo mkdir -p /opt/stacks/peanutAlém disso, navegue até o diretório recém-criado:
cd /opt/stacks/peanutPortanto, esse caminho seguirá a convenção de uso de /opt/stacks para projetos baseados em Docker Compose.
4. Crie o arquivo Docker Compose
O PeaNUT será gerenciado por um arquivo compose.yaml, que define como o contêiner será executado. Assim, vamos criá-lo usando o editor Nano.
Execute:
sudo nano compose.yamlCole o seguinte conteúdo no arquivo:
services:
peanut:
image: brandawg93/peanut:latest
container_name: PeaNUT
restart: unless-stopped
volumes:
- ./config:/config
ports:
- 8080:8080
environment:
- WEB_PORT=8080Explicação:
image: usa a imagem oficial do PeaNUT no Docker Hubrestart: garante que o contêiner reinicie se o sistema for reiniciadovolumes: mapeia a pasta./configpara salvar as configuraçõesports: expõe a porta 8080 para acesso webenvironment: define a porta da interface web
Salve o arquivo com CTRL + X, depois Y e ENTER.
🔗 Imagem Docker oficial do PeaNUT: Docker Hub – brandawg93/peanut
5. Inicie o contêiner PeaNUT
Com o arquivo de composição pronto, agora vamos iniciar o contêiner. Além disso, o Docker fará o download da imagem automaticamente.
Execute:
docker compose up -dO parâmetro -d faz o contêiner rodar em segundo plano. Consequentemente, você poderá fechar o terminal sem interromper o serviço.
Se houver algum erro, remova o -d para ver os logs em tempo real:
docker compose up6. Acesse a interface web do PeaNUT
Agora que o PeaNUT está em execução, você pode acessar sua interface web pelo navegador.
Primeiro, descubra o IP do seu Raspberry Pi:
hostname -IEm seguida, abra um navegador e acesse:
http://<IP_DO_PI>:8080Por exemplo:
http://192.168.0.100:8080Você verá a tela inicial do PeaNUT, indicando que nenhum servidor NUT foi configurado ainda.
7. Configure a conexão com o servidor NUT
Na primeira visita, o PeaNUT não consegue se comunicar com o servidor NUT. Portanto, você precisa adicionar manualmente os detalhes de conexão.
Siga os passos:
- Clique no ícone de engrenagem (⚙️) no canto superior direito.
- Em seguida, clique no sinal de + para adicionar um novo servidor.
- Preencha os campos com as informações do seu servidor NUT:
- Server Address: IP do servidor NUT (ex:
192.168.0.100) - Port:
3493(padrão do NUT) - Username: usuário configurado em
upsd.users - Password: senha do usuário NUT
- Clique em Test para verificar a conexão.
- Se funcionar, clique em Apply.
🔗 Documentação oficial do NUT: networkupstools.org
8. Verifique a conexão e visualize os dados
Se tudo estiver correto, um ícone verde aparecerá no canto superior esquerdo, indicando conexão ativa com o servidor NUT.
Além disso, você verá informações em tempo real sobre seus UPSs, como:
- Status do no-break (online, bateria, carregando)
- Nível de carga da bateria (%)
- Carga atual (em watts ou VA)
- Tensão de entrada e saída
Clique em Details para ver todos os dados técnicos disponíveis.
Integração com sistemas de monitoramento
O PeaNUT não é apenas um painel visual — ele pode ser integrado a ferramentas avançadas de monitoramento.
Além disso, ele suporta:
- Grafana + InfluxDB: para gráficos históricos de desempenho do UPS
- Prometheus: para alertas e monitoramento em tempo real
Portanto, se você já usa essas ferramentas, pode configurar o PeaNUT como fonte de dados.
🔗 Saiba mais sobre monitoramento com Grafana: grafana.com/docs
Solução de Problemas Comuns
Se o PeaNUT não se conectar ao servidor NUT, verifique:
- O servidor NUT está em execução (
sudo systemctl status nut-server) - O IP e porta estão corretos
- O usuário e senha estão configurados em
/etc/nut/upsd.users - O firewall não está bloqueando a porta 3493
Além disso, o contêiner Docker precisa acessar a rede — não use localhost, pois ele roda isolado. Use o IP local do servidor NUT.
Conclusão: PeaNUT é o dashboard ideal para seu UPS
Agora você sabe como instalar e configurar o PeaNUT no Raspberry Pi para monitorar seus no-breaks com uma interface web simples e eficiente. Além disso, graças ao Docker, a instalação é rápida, segura e fácil de manter.
Portanto, pare de usar comandos no terminal. Transforme seu Pi em um painel de energia profissional e acesse as informações do seu UPS de qualquer lugar da rede.
Se este tutorial te ajudou, compartilhe com quem usa NUT ou Raspberry Pi em casa. O futuro da automação começa com controle — e você já está no caminho certo.
 gerenciados pelo NUT. Aprenda a instalá-lo no Raspberry Pi.){kind=link}