Onde o Uptime Kuma roda na sua stack
O Uptime Kuma executa os monitores no servidor escolhido por você e apresenta o painel pelo navegador. Na imagem Docker, a porta padrão é a 3001 e a pasta /app/data preserva os arquivos da instância quando ligada a um volume local.
Ficha e sumário da página
- Referência técnica
- Uptime Kuma 2.5.11
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O processo continua na VPS
O servidor do Uptime Kuma executa as verificações e atende as conexões do painel. O navegador apresenta a interface, mas os testes continuam no processo do servidor depois que você fecha a aba. A disponibilidade desse processo determina se novos heartbeats podem ser produzidos.
Self-hosted significa que você administra a instalação e o servidor que a executa. O projeto fornece o código e a imagem Docker, enquanto a hospedagem mantém o processo, o armazenamento e a conectividade usados pela instância. Atualizar o app e preservar seus arquivos fazem parte dessa administração.
A documentação da versão 2.5.11 apresenta instalação por Docker e execução direta com Node.js. Na execução direta, o processo do servidor pode ser acompanhado pelo PM2, que o mantém em segundo plano. Nos dois formatos, você precisa manter o processo ativo para que os testes continuem depois de fechar o navegador.
A imagem Docker e o volume local
A imagem oficial é publicada como louislam/uptime-kuma. O Compose de referência do projeto usa a tag 2, que acompanha a linha principal 2.x. Uma tag que acompanha uma linha pode apontar para outro conteúdo depois de uma nova publicação, portanto a versão instalada precisa ser conferida separadamente.
O caminho /app/data reúne os arquivos que devem permanecer quando o container é recriado. O Compose oficial monta uma pasta local nesse caminho. Você preserva essa pasta ao substituir o container, para manter a configuração e o histórico armazenados pela instância.
O armazenamento precisa seguir os requisitos do projeto. O README recusa sistemas de arquivos como NFS e orienta o uso de diretório ou volume local. Apresentar uma montagem de rede como equivalente a uma pasta local ignoraria uma restrição explícita da instalação documentada.
VPSExecuta o Docker e oferece a conectividade usada pelos testes.Traefik :443Recebe HTTPS e encaminha o domínio ao Uptime Kuma.uptime-kuma :3001Atende o painel e executa os monitores./app/dataMontagem local preservada entre recriações do container.Rede de saídaAlcança os serviços monitorados e os destinos das notificações.
A porta 3001 e o proxy reverso
O serviço web atende na porta 3001 por padrão. Publicar essa porta no host permite alcançar o app diretamente, conforme o endereço de escuta e o firewall. Atrás de um proxy reverso, o acesso público pode chegar pela porta HTTPS do proxy e seguir até a porta interna do Uptime Kuma.
O Traefik usa o domínio para encaminhar a conexão ao serviço correto. O Uptime Kuma também usa WebSocket, então o caminho entre navegador e app precisa aceitar esse tipo de conexão. Uma página que abre com falhas na atualização do painel pode ter um problema nesse encaminhamento.
A documentação orienta o uso de domínio ou subdomínio próprio para a instalação. O app não oferece suporte geral à publicação sob um subdiretório arbitrário, como /monitoramento/. Essa restrição é do produto instalado, enquanto a rota /uptime-kuma/ deste portal pertence ao conteúdo editorial da Promovaweb.
O HTTPS do proxy e o acesso administrativo atendem funções diferentes. O certificado cifra a conexão e identifica o domínio. A autenticação do Uptime Kuma controla a entrada no painel, que contém configurações de monitores e credenciais das notificações. Uma configuração não substitui a outra.
A origem de cada verificação
Os testes saem da rede do processo que executa o Uptime Kuma. Dentro de um container, localhost aponta para esse container. Um serviço no host ou em outro container precisa ser alcançado pelo endereço adequado à rede utilizada, mesmo que ambos estejam na mesma VPS.
Você observa essa diferença ao comparar o endereço público com o endereço interno de um app. O primeiro percorre a resolução DNS e o proxy. O segundo pode alcançar diretamente a porta do serviço pela rede Docker. Cada caminho responde a uma pergunta diferente sobre a disponibilidade.
A posição do monitor também limita a detecção de falhas da própria máquina. Quando o Uptime Kuma e os apps dividem a VPS, uma interrupção completa dessa VPS encerra os testes e os alertas. Uma instância em outro servidor consegue verificar o endereço público mesmo durante a queda da máquina principal.
Histórico, configuração e continuidade
O volume local preserva arquivos entre recriações do container, mas não substitui uma cópia de recuperação. A perda do disco afeta o volume que está nele. Você precisa relacionar o armazenamento da instância ao procedimento de backup compatível com o banco e com a versão instalada.
As variáveis de ambiente alteram opções do servidor e de suas integrações. A referência do portal apresenta os nomes e as fontes oficiais, para distinguir uma opção do processo de uma configuração feita no painel. Valores com credenciais permanecem fora de repositórios e capturas públicas.
Quando a revisão da rede e dos monitores exige trabalho acompanhado na sua infraestrutura, o Desenvolvimento Colaborativo da Dev Side Studio oferece uma sessão técnica ao vivo. Você trabalha no editor e no terminal com orientação sobre a configuração e a investigação da falha observada.
Continue na comunidade
Leve ao Discord da Promovaweb o teste que falha ou o alerta que não chega. Informe o tipo do monitor e o destino da notificação para comparar o caminho com a comunidade.
Uma VPS para o Uptime Kuma
Uma VPS da StayCloud pode hospedar o seu Uptime Kuma com acesso root. Para observar a queda da VPS dos apps, mantenha o monitor em outra máquina.
Link de parceiro da Promovaweb.