Uptime Kuma na VPS: primeiro acesso e como monitorar seus sites

Aplicativos na VPSAtualizado em

O Uptime Kuma é um monitor de sites e servidores. Ele confere de tempos em tempos se cada endereço está respondendo e avisa você quando algo cai, por e-mail, Telegram, Discord e muitos outros canais. Também cria páginas de status públicas, para mostrar aos seus clientes se os seus serviços estão no ar.

O que vale para todos os aplicativos (SSH, log, reiniciar) está no artigo Sua VPS com aplicativo: dados de acesso, onde fica cada coisa, ver o log, reiniciar o app.

Primeiro acesso

  1. Abra o endereço que veio no e-mail: https://status.SEU-IP.yhostbr.online (o IP da VPS com traços no lugar dos pontos).
  2. No campo de usuário, use o e-mail do seu cadastro na yHost. A senha é a que veio no e-mail.
  3. O administrador já foi criado na instalação, então você entra direto no painel.

A tela aparece em português quando o seu navegador está em português. Para trocar o idioma, vá em Configurações > Aparência > Idioma e escolha Português (Brasileiro). A escolha fica salva no navegador que você está usando.

Trocar a senha

  1. Clique no ícone do seu perfil, no canto superior direito, e depois em Configurações (Settings).
  2. No menu da esquerda, abra Segurança (Security).
  3. Em Mudar senha, preencha Senha atual, Nova Senha e Repetir Nova Senha.
  4. Clique em Atualizar Senha.

Primeiros passos

Adicionar o primeiro monitor

  1. Clique em Adicionar novo monitor (Add New Monitor). No celular, o botão se chama Adicionar.
  2. Em Tipo de Monitor, escolha HTTP(s) para conferir um site. Também há tipos para ping, porta, DNS e outros.
  3. Em Apelido, dê um nome para o monitor (por exemplo, "Meu site"). Em URL, cole o endereço completo, com https://.
  4. Em Intervalo de Heartbeat, escolha de quantos em quantos segundos ele confere o site.
  5. Clique em Salvar.

Receber avisos quando algo cair

  1. Vá em Configurações > Notificações e clique em Configurar Notificação.
  2. Escolha o canal (Telegram, Discord, e-mail por SMTP e muitos outros) e preencha os dados que ele pede. Para avisos por e-mail, você precisa dos dados de uma conta de e-mail sua (servidor SMTP).
  3. Faça um teste e salve.
  4. Abra cada monitor e marque essa notificação, na parte Notificações da tela dele.

Criar uma página de status

  1. No topo, clique em Página de Status e depois em Nova Página De Status.
  2. Preencha Nome e Apelido. Aqui, o apelido é o pedaço do endereço da página: use letras minúsculas, sem espaços. Clique em Próximo.
  3. Escolha os monitores que vão aparecer e salve. A página fica em https://status.SEU-IP.yhostbr.online/status/APELIDO.
O Uptime Kuma roda dentro desta VPS. Se a própria VPS sair do ar, ele não consegue avisar. Por isso ele é ideal para monitorar outros sites e servidores.

Onde roda na VPS

Pasta /opt/yhost/kuma
Container kuma (os dados ficam num banco SQLite dentro do volume do app)
Reiniciar cd /opt/yhost/kuma e depois docker compose restart

Problemas comuns

A página não abre logo depois da criação

A instalação leva de 2 a 6 minutos depois que a VPS liga. Espere uns 10 minutos e tente de novo numa janela anônima. Para acompanhar, veja o log da instalação pelo SSH: tail -n 30 /var/log/yhost-app.log.

O navegador avisa que a conexão não é segura

O certificado HTTPS ainda não saiu. Ele costuma sair poucos minutos depois da instalação e, se o endereço da VPS demorou a ficar pronto, o sistema tenta de novo sozinho a cada 10 minutos. Espere e recarregue a página. Enquanto o aviso aparecer, não digite sua senha. Se o aviso continuar depois de 1 hora, abra um chamado.

Esqueci a senha

Se você ainda não trocou a senha, a original está na VPS, no arquivo /root/yhost-app.txt (use cat /root/yhost-app.txt). Se já trocou e esqueceu, defina uma nova pela ferramenta oficial do Uptime Kuma, entrando na VPS pelo SSH:

cd /opt/yhost/kuma
docker compose exec -w /app kuma npm run reset-password

O comando pede a senha nova duas vezes (New Password e Confirm New Password). Senhas fracas são recusadas.

Não recebo os avisos

Abra a notificação em Configurações > Notificações e use o botão de teste. Confira também se a notificação está marcada dentro de cada monitor.

Precisa de ajuda?

Abra um chamado em https://yhost.com.br/painel/suporte. Informe o IP da VPS e o que aconteceu. Se tiver uma mensagem de erro, mande um print.

Ainda com dúvida? A nossa equipe ajuda pelo chamado.

Abrir chamado