Tutoriais

Hospedando Uptime Kuma para monitorar seus sites

Hospedando Uptime Kuma para monitorar seus sites

Descobrir que o site caiu porque um cliente reclamou é a pior forma de saber. O Uptime Kuma é uma ferramenta de monitoramento self-hosted, bonita e fácil de usar, que avisa você assim que algo sai do ar.

O que o Uptime Kuma monitora

  • HTTP(S) — status e, opcionalmente, palavras-chave na página;
  • Portas TCP — banco de dados, servidor de jogo, SMTP;
  • Ping;
  • DNS — registros esperados;
  • Validade de certificados SSL;
  • Containers Docker;
  • Push — para tarefas agendadas (ex.: o backup avisa quando termina; se não avisar, você recebe alerta).

Notificações

Mais de 90 canais, incluindo Telegram, Discord, Slack, e-mail (SMTP), Microsoft Teams, webhooks e diversos serviços de push.

Onde hospedar

Dica importante: o monitor deve ficar fora do servidor monitorado. Se o VPS do seu site cair, um Uptime Kuma no mesmo servidor cai junto. Use um VPS pequeno separado — ele pode monitorar vários servidores e sites.

Instalação com Docker

docker volume create uptime-kuma
docker run -d --name uptime-kuma --restart unless-stopped \
  -p 127.0.0.1:3001:3001 \
  -v uptime-kuma:/app/data \
  louislam/uptime-kuma:1

Consulte o repositório oficial para a tag da versão estável mais recente.

Ou com Docker Compose:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    restart: unless-stopped
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - uptime-kuma:/app/data

volumes:
  uptime-kuma:

Proxy reverso com HTTPS

server {
    server_name status.seudominio.com.br;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
sudo certbot --nginx -d status.seudominio.com.br

O WebSocket (cabeçalhos Upgrade/Connection) é necessário para a interface funcionar.

Primeiros passos

  1. Crie a conta de administrador;
  2. Configurações → Notificações: adicione seu canal (ex.: bot do Telegram);
  3. Adicionar monitor:
    • Tipo: HTTP(s);
    • URL: https://seusite.com.br;
    • Intervalo: 60 segundos;
    • Tentativas antes de alertar: 2 ou 3 (evita falsos positivos);
  4. Ative o aviso de expiração do certificado.

Página de status pública

Crie uma Status Page e compartilhe com clientes — transparência reduz chamados durante incidentes. É possível usar um domínio próprio.

Monitorando tarefas com Push

No monitor do tipo Push, o Uptime Kuma gera uma URL. Chame-a ao final do backup:

/usr/local/bin/backup.sh && curl -fsS "https://status.seudominio.com.br/api/push/TOKEN?status=up&msg=OK"

Se o backup não rodar no intervalo definido, você recebe um alerta.

Segurança

  • Ative 2FA na conta;
  • Mantenha o container atualizado;
  • Faça backup do volume de dados.

Conclusão

Com Uptime Kuma, você fica sabendo dos problemas antes dos seus clientes.Um VPS pequeno é suficiente — conheça os planos VPS-NVME-BR da VittHost e use o cupom SP-VITT20 para ganhar 20% de desconto na primeira fatura enquanto a promoção estiver ativa.

Compartilhar:

Pronto para hospedar seu próximo projeto?

VPS com painel pré-instalado em 1 clique. Ativação imediata.

Ver planos VPS