Começar
Todos os aplicativos para VPS
Monitoramento

Uptime Kuma: monitoramento de disponibilidade no seu próprio servidor

Um monitor auto-hospedado que verifica seus sites e serviços a cada minuto e avisa no instante em que um deles para de responder.

Contratar um servidor com Uptime Kuma Ver planos de VPS

Sobre o Uptime Kuma

O Uptime Kuma é uma ferramenta de monitoramento de código aberto criada pelo desenvolvedor Louis Lam e hoje um dos projetos auto-hospedados com mais estrelas no GitHub. Ele verifica se as coisas respondem: sites por HTTP(S), palavras-chave em uma página, portas TCP, ping, registros DNS, bancos de dados e mais.

Quando uma verificação falha, ele envia uma notificação por um dos vários canais suportados, entre eles Telegram, Discord, Slack, e-mail e webhooks. Ele também acompanha os tempos de resposta, avisa antes de os certificados TLS expirarem e permite montar páginas de status públicas para seus clientes.

As pessoas o hospedam por conta própria porque ele é leve, gratuito e tem uma interface limpa que se configura em minutos. Rodá-lo em um servidor separado é o detalhe essencial: um monitor que fica na mesma máquina que o seu site não consegue avisar quando essa máquina cai.

Para que as pessoas usam

Alertas quando um site cai

Verifique seu site e sua API a cada minuto e receba uma mensagem no Telegram ou por e-mail assim que eles pararem de responder.

Avisos de expiração de certificado

Seja lembrado dias antes de um certificado HTTPS vencer, em vez de ficar sabendo pelos clientes.

Uma página de status pública

Mostre aos clientes o estado atual dos seus serviços em uma página que você controla.

Depois da contratação

A primeira inicialização do servidor instala o Uptime Kuma e abre a porta 3001 no firewall, então o monitor fica acessível em http://endereco-do-servidor:3001/. Na primeira visita, você cria a conta de administrador, então abra o endereço assim que o servidor estiver pronto. Depois, adicione seu primeiro monitor e conecte um canal de notificação.

Onde rodar

O Uptime Kuma verifica a partir de onde está rodando. Um monitor no mesmo servidor dos serviços que ele vigia cai junto com eles e não consegue avisar você, então mantenha-o em um servidor separado do que ele monitora.

Domínio próprio e HTTPS para o Uptime Kuma

Logo após a instalação, o Uptime Kuma responde no endereço IP do servidor, por HTTP simples. Para dar a ele um nome como status.example.com com certificado, crie no seu DNS um registro A para esse nome apontando para o endereço IPv4 do servidor e coloque o Caddy na frente: o Caddy obtém sozinho um certificado gratuito da Let's Encrypt e o renova. Os comandos abaixo são para o Ubuntu 24.04, que nossos servidores de aplicativos usam.

No painel, abra as portas TCP 80 e 443 no firewall do servidor: o Caddy precisa delas para obter o certificado da Let's Encrypt e servir o site.

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
    reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddy

Com um domínio na frente, as páginas de status do Uptime Kuma podem ser compartilhadas com seus clientes: crie uma página de status, escolha quais monitores ela mostra e divulgue https://status.example.com/status/sua-pagina. Você também pode associar o domínio diretamente a uma página de status nas configurações dela.

Quando o domínio estiver funcionando, ninguém mais precisa da porta 3001 direta: em /opt/uptime-kuma/compose.yml, troque "3001:…" por "127.0.0.1:3001:…", rode docker compose up -d e remova a porta 3001 do firewall. A partir daí, o Uptime Kuma só pode ser acessado por HTTPS.

Atualizar o Uptime Kuma

As imagens em /opt/uptime-kuma/compose.yml estão fixadas em versões exatas, então um simples docker compose pull baixa a mesma versão de novo. Para atualizar, troque a versão na linha image: pela que você quer (leia antes as notas da versão), baixe a imagem e recrie os contêineres. Os dados ficam em volumes do Docker e são preservados.

cd /opt/uptime-kuma
nano compose.yml        # the new version in the image: line
docker compose pull
docker compose up -d

Backup do Uptime Kuma

No painel, você pode ativar backups diários do servidor inteiro (+20% sobre o preço do plano, com as últimas 7 cópias guardadas) e restaurar o servidor a partir de qualquer uma delas. Mesmo assim, vale ter uma cópia dos dados do próprio aplicativo em um arquivo: ela pode ser levada para outro servidor ou restaurada sem voltar todo o resto no tempo.

Os monitores, as configurações de notificação e o histórico de verificações ficam no volume uptime-kuma_uptime_kuma (/app/data). Pare o aplicativo por um instante para que o arquivo do banco de dados seja copiado em um estado consistente:

cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
  tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start

Como funciona

  1. Escolha o Uptime Kuma na página de contratação do servidor e um plano com memória suficiente.
  2. O aplicativo é instalado no servidor na primeira inicialização, normalmente em poucos minutos.
  3. Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.

Dúvidas sobre o Uptime Kuma

Sim. O Uptime Kuma é leve: 1 GB de memória e 20 GB de disco é o mínimo e dá conta com folga de dezenas de monitores. Centenas de monitores com intervalos curtos ficam melhor com 2 GB.
De preferência, não. Se eles dividem um servidor e ele falha, o monitor cai junto e nenhum alerta é enviado. Um servidor pequeno e separado é a configuração confiável.
Sim. Um plano ARM pequeno serve tão bem quanto um x86.
Pelos canais de notificação que você configurar no Uptime Kuma: Telegram, e-mail via SMTP, Slack, Discord, webhooks e muitos outros. Adicione um canal uma vez e associe-o aos monitores.
A primeira pessoa que abrir o endereço cria a conta de administrador, então abra http://endereco-do-servidor:3001/ assim que o servidor estiver pronto.

Outros aplicativos em Monitoramento