Ir para o conteúdo
Promovaweb

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
  1. O processo continua na VPS
  2. A imagem Docker e o volume local
  3. A porta 3001 e o proxy reverso
  4. A origem de cada verificação
  5. Histórico, configuração e continuidade

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.
O proxy recebe o acesso público, o Uptime Kuma atende na porta interna e o volume preserva os arquivos da instância.

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.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.