Sim, você pode monitorar sites, APIs, portas e outros serviços com o Uptime Kuma usando Docker. A ferramenta é um monitor de disponibilidade auto-hospedado: ela faz verificações periódicas, registra o histórico e pode avisar por canais como Telegram, Discord, e-mail e Slack quando algo falha.
O caminho mais simples é instalar a imagem oficial com Docker Compose, abrir o painel na porta 3001 e criar um monitor HTTP para o seu endereço. A documentação do projeto consultada em 20 de agosto de 2026 também alerta que o diretório de dados deve ficar em um volume ou pasta local, não em NFS.
O que é o Uptime Kuma?
O Uptime Kuma é uma ferramenta de monitoramento de código aberto que você instala no seu próprio servidor, computador ou NAS compatível. Em vez de esperar alguém perceber que um site caiu, o sistema acessa o serviço em intervalos definidos e registra se recebeu uma resposta válida.
Ele não é um observador mágico de toda a infraestrutura. Pense nele como um vigia que faz perguntas objetivas: “a página responde?”, “a porta está acessível?”, “o DNS resolve?” ou “o conteúdo esperado apareceu?”. Esse modelo resolve muitos problemas de disponibilidade sem exigir uma plataforma paga de observabilidade.
| Tipo de monitor | Para que serve |
|---|---|
| HTTP(s) | Verificar se um site ou endpoint responde. |
| HTTP(s) Keyword | Confirmar se uma palavra ou trecho esperado aparece na página. |
| TCP | Checar se uma porta aceita conexão. |
| Ping | Verificar a resposta básica de um host. |
| DNS | Acompanhar a resolução de um registro. |
| Push | Receber um sinal periódico de um processo ou script. |
A lista oficial também inclui WebSocket, consulta JSON por HTTP(s), servidores de jogos, containers Docker e outras modalidades. Os recursos disponíveis podem mudar conforme a versão instalada.
O que você precisa antes da instalação
- Um computador, servidor ou VPS com Docker e Docker Compose;
- permissão para criar uma pasta e executar containers;
- um serviço que você queira monitorar, como um site, API ou servidor;
- um canal de notificação, caso queira receber alertas fora do painel.
Para um teste local, o próprio computador já é suficiente. Para monitorar um site público com alguma independência, faz mais sentido instalar o Uptime Kuma em outro ambiente. Se o monitor e o site estiverem na mesma máquina, uma falha nessa máquina pode derrubar os dois ao mesmo tempo.
Como instalar o Uptime Kuma com Docker Compose
A instalação recomendada pelo repositório oficial usa um arquivo Compose. No terminal do servidor, execute:
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -dDepois que o container iniciar, abra http://localhost:3001 no próprio servidor. Se o acesso for remoto, troque localhost pelo IP ou domínio configurado para a máquina.
O comando publicado pelo projeto expõe o serviço em todas as interfaces de rede. Isso é prático para começar, mas não significa que a porta 3001 deva ficar aberta diretamente na internet. Em uma instalação pública, prefira um proxy reverso com HTTPS e restrinja o acesso ao painel administrativo.
Como abrir o painel pela primeira vez
- Acesse o endereço do Uptime Kuma no navegador.
- Crie a conta de administrador quando a tela inicial solicitar.
- Escolha um nome de monitor e defina o tipo de verificação.
- Salve e confira se o status muda para Up quando o serviço responder.
Use uma senha exclusiva para o painel e ative a autenticação de dois fatores quando a opção estiver disponível para a sua conta. O README do projeto lista suporte a 2FA, mas a configuração exata pode variar entre versões.
Como criar o primeiro monitor HTTP
Para acompanhar um site, clique em Add New Monitor e selecione HTTP(s). Preencha os campos principais:
- Friendly Name: um nome fácil de reconhecer, como “Site da empresa”;
- URL: o endereço completo que será acessado;
- intervalo: o tempo entre as verificações;
- notificação: o canal que receberá o alerta, se configurado.
Comece monitorando uma URL que realmente indique a saúde do serviço. A página inicial pode responder mesmo quando uma função importante está quebrada. Para uma API, prefira um endpoint de saúde que retorne um status conhecido e não exija dados sensíveis na URL.
Se a página precisa conter uma frase específica, use o monitor de palavra-chave. Essa verificação ajuda a detectar uma página de erro que, por acidente, ainda devolve o código HTTP 200. Ela também tem limite: encontrar uma palavra não prova que login, banco de dados ou pagamento estejam funcionando.
Como configurar alertas sem criar uma tempestade de notificações
O Uptime Kuma lista integrações com Telegram, Discord, Gotify, Slack, Pushover, SMTP e dezenas de outros serviços. Configure pelo menos um canal externo ao servidor monitorado. Se o painel ficar indisponível, um alerta salvo apenas dentro dele não ajudará muito.
Também evite alertar a cada oscilação curta. Use um intervalo e uma política de repetição que façam sentido para o serviço. Um blog pessoal pode tolerar alguns minutos; uma API usada no atendimento de clientes talvez precise de uma resposta mais rápida. O objetivo é receber sinais úteis, não transformar cada pacote perdido em emergência.
Como criar uma página pública de status
Uma página de status mostra aos visitantes se os serviços selecionados estão funcionando. Ela é útil para empresas que preferem comunicar uma instabilidade em vez de responder individualmente às mesmas perguntas.
O recurso tem uma particularidade importante: segundo a wiki oficial, a página pública pode armazenar os resultados em cache por cinco minutos e atualizar a visualização nesse intervalo. Portanto, ela não deve ser tratada como um painel em tempo real. Para investigar uma falha, use o painel administrativo e os alertas.
Escolha apenas monitores que possam ser divulgados. Nomes internos, endereços privados e detalhes da infraestrutura não precisam aparecer para qualquer pessoa. Se quiser publicar a página em um domínio próprio, configure o DNS e o proxy reverso de acordo com a documentação do projeto.
Cuidados com proxy reverso, dados e backups
O Uptime Kuma usa WebSocket em partes da interface. A documentação de instalação informa que o proxy reverso precisa encaminhar os cabeçalhos Upgrade e Connection para que essa comunicação funcione corretamente. Sem isso, o painel pode carregar de forma incompleta ou perder atualizações.
O container guarda os dados em /app/data. Monte esse caminho em um volume ou pasta local persistente. O projeto alerta para problemas de bloqueio de arquivos e possível corrupção do SQLite em sistemas como NFS. Faça cópias de segurança do volume e teste a restauração; um backup que nunca foi restaurado ainda é uma promessa.
Se você já usa um túnel para publicar um serviço local, pode complementar a instalação com o guia sobre como usar o Cloudflare Tunnel para acessar um serviço sem abrir portas. O túnel não substitui autenticação, atualizações e controle de acesso, mas pode reduzir a exposição direta da máquina.
Limitações: quando o Uptime Kuma não é suficiente
O Uptime Kuma é forte em verificações simples e em controle dos próprios dados, mas não deve ser confundido com uma suíte completa de observabilidade ou testes sintéticos. Uma análise independente publicada no DEV Community em abril de 2026 destaca três limites práticos: a instância costuma monitorar a partir de um único local, não executa um navegador real para testar um login e não encadeia várias requisições de API usando o resultado de uma como entrada da próxima.
- Um único local: seu servidor pode enxergar o site normalmente enquanto usuários de outra região enfrentam falhas de DNS ou rota.
- Sem teste de navegador: uma página pode devolver 200 OK e ainda ter um login quebrado, um token expirado ou um fluxo OAuth com problema.
- Dependência do próprio servidor: se o host do Uptime Kuma cair, o monitoramento e os alertas daquela instância também param.
- Manutenção: você continua responsável por atualizar a imagem, proteger o painel, cuidar do volume e verificar os backups.
Para um site pessoal, laboratório, rede interna ou pequena equipe, essas limitações podem ser aceitáveis. Para um sistema crítico, combine a ferramenta com monitoramento externo, verificações de navegador e métricas da aplicação. O erro seria chamar de “gratuito” algo que ainda exige servidor, tempo e responsabilidade operacional.
Uptime Kuma vale a pena?
Vale a pena quando você quer monitoramento auto-hospedado, sem mensalidade pelo software e com controle sobre os dados. A instalação por Docker é curta, a interface é mais amigável que muitas soluções tradicionais e a variedade de canais de alerta atende boa parte dos cenários domésticos e de pequenas empresas.
Ele deixa de ser a escolha ideal quando a prioridade é monitorar usuários de várias regiões, validar fluxos completos de login e API ou garantir que o monitor continue ativo mesmo se o seu servidor principal falhar. Nesse caso, a opção mais segura é usar o Uptime Kuma como uma camada interna e contratar ou configurar uma segunda camada externa.
Perguntas frequentes
O Uptime Kuma é gratuito?
O software é de código aberto e pode ser executado sem cobrança de licença. Ainda assim, você pode ter custos com servidor, armazenamento, domínio, backups e manutenção.
Posso instalar o Uptime Kuma em um computador com Windows?
Sim. O projeto documenta execução nativa em versões compatíveis do Windows e também pode ser usado com Docker Desktop. Verifique os requisitos da versão escolhida antes de instalar.
O Uptime Kuma testa se o login do meu site funciona?
Não como um navegador real. Ele pode verificar uma URL, uma palavra-chave ou a resposta de um serviço, mas não substitui um teste que abre a página, preenche credenciais e confirma uma sessão autenticada.
Por que a página pública de status demora para atualizar?
A wiki oficial informa que a página pública usa cache de até cinco minutos e atualiza nesse intervalo. Para acompanhar uma falha imediatamente, consulte o painel e o canal de alerta configurado.