---
title: "Como instalar Uptime Kuma na VPS e monitorar sites e portas"
description: "Instale o Uptime Kuma com Docker na VPS, publique com HTTPS no Nginx e monitore sites, APIs e portas com alertas no Discord, Telegram e email."
url: "https://streethosting.com.br/guias/vps/monitoramento-vps-com-uptime-kuma"
category: "vps"
slug: "monitoramento-vps-com-uptime-kuma"
datePublished: "2026-06-01"
dateModified: "2026-09-28"
author: "Equipe StreetHosting"
difficulty: "intermediario"
language: "pt-BR"
keywords:
  - "monitoramento vps uptime kuma"
  - "como monitorar vps"
  - "uptime kuma tutorial"
  - "alerta de queda servidor"
  - "instalar uptime kuma docker"
  - "monitorar porta tcp servidor"
---

# Uptime Kuma na VPS: instalação com Docker, HTTPS, monitores e alertas

O Uptime Kuma testa sites, APIs, portas e tarefas agendadas em intervalos e avisa quando algo sai do ar. Veja como instalar com Docker, publicar com HTTPS, escolher o tipo de monitor e ligar os alertas.

> **Resposta rápida**
>
> O **monitoramento da VPS com Uptime Kuma** funciona assim: ele testa seus serviços em intervalos e envia alertas quando detecta falha. Instale com Docker Compose, publique o painel atrás do Nginx com HTTPS e crie monitores HTTP, Keyword, TCP, Ping, DNS e Push para cada serviço. Sempre que puder, rode o Uptime Kuma fora da VPS monitorada, porque um monitor que cai junto com o servidor nunca avisa.

## Por que monitorar e onde rodar

Sem monitoramento, muitas quedas só são percebidas quando o cliente reclama. Com alerta automático, sua equipe reage mais cedo e reduz impacto. O Uptime Kuma é uma ferramenta de código aberto que você hospeda na sua própria máquina: não há limite de monitores nem mensalidade, e os dados ficam com você.

A decisão mais importante vem antes da instalação: onde o Uptime Kuma vai rodar. Na mesma VPS que ele vigia, ele detecta a aplicação que travou, o site que passou a responder erro e o certificado que venceu. Mas se a VPS inteira cair, ficar sem rede ou travar por falta de memória, o monitor cai junto e o alerta nunca sai. O arranjo que detecta os dois tipos de falha é uma VPS pequena só para monitoramento, olhando as máquinas de produção de fora. A estratégia completa, com métricas internas e limites de alerta, está em [como monitorar uma VPS 24 horas](https://streethosting.com.br/guias/vps/monitorar-vps-24-horas).

## Instalar com Docker Compose

O jeito mais simples de instalar e atualizar é com Docker. Se a VPS ainda não tem, comece por [instalar Docker no Ubuntu](https://streethosting.com.br/guias/vps/instalar-docker-ubuntu-vps). Depois crie uma pasta para o serviço e o arquivo `compose.yaml`:

```
sudo mkdir -p /opt/uptime-kuma && cd /opt/uptime-kuma
sudo nano compose.yaml
```

```
services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data:/app/data
```

Dois detalhes fazem diferença. O `127.0.0.1:3001:3001` publica o painel só no localhost da VPS: portas publicadas pelo Docker passam por fora das regras do UFW, e sem esse prefixo a 3001 ficaria aberta para a internet mesmo com o firewall ativo. E a pasta `./data` guarda o banco, os monitores e o histórico; é ela que entra no backup.

```
sudo docker compose up -d
sudo docker compose logs -f
```

> **Atenção**
>
> Quem abrir o painel primeiro cria a conta de administrador. Faça a configuração inicial por um túnel SSH antes de publicar o domínio: `ssh -L 3001:127.0.0.1:3001 usuario@IP_DA_VPS` e o navegador em http://localhost:3001. Na versão 2, a primeira tela pergunta qual banco usar; para algumas dezenas de monitores, o SQLite resolve sem nenhum serviço extra.

## Domínio e HTTPS com Nginx

Com a conta criada, publique o painel num subdomínio como `kuma.seu-dominio.com.br`. O Uptime Kuma atualiza a tela por WebSocket, então o proxy precisa repassar os cabeçalhos de upgrade; sem eles, o painel fica carregando para sempre. O passo a passo geral do Nginx como proxy está em [configurar o Nginx como reverse proxy](https://streethosting.com.br/guias/vps/configurar-nginx-reverse-proxy-vps); o bloco específico fica assim:

```
# /etc/nginx/sites-available/uptime-kuma
server {
    listen 80;
    server_name kuma.seu-dominio.com.br;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

```
sudo ln -s /etc/nginx/sites-available/uptime-kuma /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d kuma.seu-dominio.com.br
```

Depois, em Configurações e Proxy Reverso, marque Trust Proxy como sim. Assim o Uptime Kuma registra o IP real de quem acessa, e não o 127.0.0.1 do Nginx. Aproveite para ativar a autenticação em dois fatores em Configurações e Segurança: esse painel guarda webhooks e tokens de todos os seus canais de alerta.

## Tipos de monitor e configuração

Cada monitor testa uma coisa só, e escolher o tipo certo é o que separa um alerta útil de um falso tranquilizante. Os mais usados:

| Tipo | O que verifica | Exemplo de uso |
| --- | --- | --- |
| HTTP(s) | Se a URL responde com status de sucesso | Site, painel, rota de saúde da API |
| HTTP(s) Keyword | Se a resposta contém uma palavra esperada | Página que devolve 200 mas mostra erro de banco |
| HTTP(s) Json Query | O valor de um campo numa resposta JSON | API que informa status ok no corpo |
| TCP Port | Se a porta aceita conexão | SSH, banco de dados, servidor de jogo em TCP |
| Ping | Se o host responde ao ICMP | Saber se a VPS inteira está de pé |
| DNS | Se o registro resolve para o valor esperado | Detectar mudança acidental no registro A |
| Push | Se algo chamou a URL do monitor dentro do intervalo | Backup, tarefa cron, worker sem porta aberta |
| Docker Container | Se o container está em execução | Serviços que rodam na mesma máquina do Kuma |

Um HTTP puro diz que o servidor respondeu, não que a aplicação funciona. Uma loja com o banco fora do ar pode devolver status 200 com uma página de erro. O monitor Keyword, procurando uma palavra que só aparece quando tudo está certo, pega esse caso. Da mesma forma, o ping prova que a máquina está de pé, mas não que o serviço responde, e alguns servidores bloqueiam ICMP. Use o ping como complemento, nunca como único teste. E lembre que TCP Port não testa UDP: servidores de jogo que usam UDP pedem o monitor específico para jogos.

### Intervalo, tentativas e certificado

1. Intervalo de 60 segundos atende a maioria dos serviços; 30 segundos só para o que é crítico.
2. Em Tentativas, use 2 ou 3, com intervalo de nova tentativa curto: uma oscilação isolada não acorda ninguém.
3. Nos monitores HTTP, ative o aviso de expiração do certificado. A antecedência, em dias, fica nas configurações de notificação.
4. Teste uma queda simulada, parando o serviço, para validar o monitor e a notificação.

> **Dica**
>
> O modo invertido (Upside Down Mode) alerta quando o teste passa. Com um monitor TCP apontando para a porta do banco de dados ou do `node_exporter` a partir de outra máquina, você recebe aviso se uma regra de firewall sumir e a porta ficar exposta.

## Notificações no Discord, Telegram e email

As notificações ficam em Configurações e Notificações, com o botão de configurar notificação. Cada canal é cadastrado uma vez e depois ligado nos monitores que vão usar esse canal.

- **Discord:** no servidor, abra Configurações do servidor, Integrações e Webhooks, crie um webhook no canal da equipe e cole a URL no tipo Discord do Uptime Kuma.
- **Telegram:** crie um bot conversando com o @BotFather e copie o token. Mande qualquer mensagem para o bot (ou adicione o bot ao grupo da equipe) e use o botão de obter automaticamente para preencher o Chat ID.
- **Email:** use o SMTP do seu provedor de email, na porta 587 com STARTTLS ou 465 com SSL/TLS, com usuário, senha de aplicativo, remetente e destinatário.

Marque a opção de ativar por padrão para que monitores novos já nasçam com o canal, e a de aplicar em todos os monitores existentes quando estiver criando o primeiro canal. Clique em Testar antes de salvar: é o único jeito de saber que o alerta chega antes de precisar dele. Como organizar canais, separar avisos da equipe dos avisos públicos e evitar ruído está em [alertas de queda no Discord ou Telegram](https://streethosting.com.br/guias/infraestrutura/monitoramento-uptime-alertas-discord-telegram).

Para backups e tarefas agendadas, o monitor Push inverte a lógica: o script chama a URL ao terminar com sucesso, e o silêncio vira alerta.

```
# última linha do script, só roda se tudo antes deu certo
curl -fsS -m 10 "https://kuma.seu-dominio.com.br/api/push/SEU_TOKEN?status=up&msg=OK" > /dev/null
```

## Boas práticas e manutenção

> **Dica**
>
> Defina nome claro para cada monitor. Isso facilita quando a equipe recebe alerta em horário de pico: “API produção: checkout” diz muito mais que “monitor 7”.

- [ ] Monitorar serviço interno e página pública.
- [ ] Separar alerta crítico de alerta informativo.
- [ ] Registrar incidentes para aprender com falhas.
- [ ] Revisar contatos de alerta todos os meses.
- [ ] Criar janela de manutenção antes de reiniciar ou atualizar um serviço.
- [ ] Incluir a pasta de dados do Uptime Kuma no backup.

As janelas de manutenção pausam os alertas dos monitores escolhidos por um período, para que uma atualização planejada não dispare notificação. As páginas de status publicam o estado dos serviços para clientes ou jogadores, com domínio próprio; o que mostrar nelas e como comunicar um incidente está em [criar uma status page para incidentes](https://streethosting.com.br/guias/infraestrutura/criar-status-page-incidentes).

Para atualizar, basta baixar a imagem nova e recriar o container. Os dados ficam na pasta montada e não se perdem:

```
cd /opt/uptime-kuma
sudo docker compose pull && sudo docker compose up -d
```

Antes de trocar de versão principal, leia as notas de lançamento e copie a pasta de dados. Para uma cópia consistente com SQLite, pare o container, copie `./data` e suba de novo, ou coloque a pasta na rotina de [backup automático com restic](https://streethosting.com.br/guias/vps/automatizar-backup-vps-restic-cron). Por fim, mantenha só as portas 22, 80 e 443 abertas no [firewall UFW](https://streethosting.com.br/guias/vps/firewall-ufw-vps-ubuntu): o painel já passa pelo Nginx.

## Qual VPS usar para o Uptime Kuma

O Uptime Kuma é leve. Com SQLite e algumas dezenas de monitores, ele costuma ficar na casa de poucas centenas de MB de RAM, e o menor plano de VPS já sobra. Na StreetHosting, a VPS Xeon começa em R$ 26,00 por mês com 2 vCPU, 2 GB de RAM e 20 GB de NVMe, com AntiDDoS Enterprise, e é a escolha natural para uma máquina só de monitoramento. A VPS Ryzen 9 9950X começa em R$ 42,00 com 1 vCPU, 2 GB de DDR5 e 20 GB de NVMe, se você preferir concentrar tudo na mesma linha da produção.

As duas ficam em São Paulo, com acesso root, ativação em até 60 segundos e pagamento por Pix, boleto ou cartão. Uma ressalva honesta: uma VPS de monitoramento no mesmo datacenter da produção detecta queda de máquina, de aplicação e de rede da VPS, mas não uma falha que atinja o datacenter inteiro. Para cobrir esse caso, mantenha também um teste a partir de outra rede, nem que seja uma segunda instância do Uptime Kuma em casa vigiando a primeira. Compare os planos na [página de VPS](https://streethosting.com.br/vps).

## Perguntas frequentes

### Uptime Kuma substitui suporte técnico?

Não. Ele avisa quando há falha e mostra desde quando o serviço está fora e qual erro apareceu, o que encurta o diagnóstico. A investigação e a correção continuam sendo trabalho de quem administra o servidor.

### Posso monitorar mais de um serviço?

Sim. Um único painel pode vigiar sites, APIs, portas TCP, registros DNS, containers e tarefas agendadas de várias VPS ao mesmo tempo, cada monitor com seu intervalo e suas notificações.

### É difícil configurar?

Não. Com Docker, a instalação é um arquivo de poucas linhas e um comando. O que exige mais cuidado é publicar o painel com HTTPS, criar a conta de administrador antes de expor a porta e ajustar as tentativas para evitar alarme falso.

### Posso instalar o Uptime Kuma na mesma VPS que ele monitora?

Pode, mas ele só enxerga falhas de aplicação. Se a VPS inteira cair, o monitor cai junto e nenhum alerta sai. Para detectar queda da máquina, rode o Uptime Kuma em outra VPS ou em outra rede.

### Como monitorar um backup ou uma tarefa cron com o Uptime Kuma?

Use um monitor do tipo Push. Ele gera uma URL que o seu script chama com curl ao terminar com sucesso. Se a chamada não chegar dentro do intervalo configurado, o monitor fica fora e o alerta dispara.

## Guias relacionados

- [Como monitorar uma VPS 24 horas: métricas, alertas e uptime](https://streethosting.com.br/guias/vps/monitorar-vps-24-horas.md)
- [Como receber alertas de queda do servidor no Discord ou Telegram](https://streethosting.com.br/guias/infraestrutura/monitoramento-uptime-alertas-discord-telegram.md)
- [Como instalar Docker no Ubuntu 22.04 ou 24.04 em VPS (guia direto ao ponto)](https://streethosting.com.br/guias/vps/instalar-docker-ubuntu-vps.md)
- [Como configurar o Nginx como reverse proxy na VPS](https://streethosting.com.br/guias/vps/configurar-nginx-reverse-proxy-vps.md)
- [Como criar status page para incidentes de servidor](https://streethosting.com.br/guias/infraestrutura/criar-status-page-incidentes.md)

## Produtos citados

- https://streethosting.com.br/vps
- https://streethosting.com.br/vps/xeon

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "@type": [
      "Article",
      "TechArticle"
    ],
    "headline": "Uptime Kuma na VPS: instalação com Docker, HTTPS, monitores e alertas",
    "name": "Como instalar Uptime Kuma na VPS e monitorar sites e portas",
    "abstract": "O Uptime Kuma testa sites, APIs, portas e tarefas agendadas em intervalos e avisa quando algo sai do ar. Veja como instalar com Docker, publicar com HTTPS, escolher o tipo de monitor e ligar os alertas.",
    "description": "Instale o Uptime Kuma com Docker na VPS, publique com HTTPS no Nginx e monitore sites, APIs e portas com alertas no Discord, Telegram e email.",
    "datePublished": "2026-06-01",
    "dateModified": "2026-09-28",
    "author": {
      "@type": "Organization",
      "name": "Equipe StreetHosting"
    },
    "publisher": {
      "@type": "Organization",
      "name": "StreetHosting",
      "url": "https://streethosting.com.br"
    },
    "inLanguage": "pt-BR",
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://streethosting.com.br/guias/vps/monitoramento-vps-com-uptime-kuma"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Uptime Kuma substitui suporte técnico?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Não. Ele avisa quando há falha e mostra desde quando o serviço está fora e qual erro apareceu, o que encurta o diagnóstico. A investigação e a correção continuam sendo trabalho de quem administra o servidor."
        }
      },
      {
        "@type": "Question",
        "name": "Posso monitorar mais de um serviço?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Sim. Um único painel pode vigiar sites, APIs, portas TCP, registros DNS, containers e tarefas agendadas de várias VPS ao mesmo tempo, cada monitor com seu intervalo e suas notificações."
        }
      },
      {
        "@type": "Question",
        "name": "É difícil configurar?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Não. Com Docker, a instalação é um arquivo de poucas linhas e um comando. O que exige mais cuidado é publicar o painel com HTTPS, criar a conta de administrador antes de expor a porta e ajustar as tentativas para evitar alarme falso."
        }
      },
      {
        "@type": "Question",
        "name": "Posso instalar o Uptime Kuma na mesma VPS que ele monitora?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Pode, mas ele só enxerga falhas de aplicação. Se a VPS inteira cair, o monitor cai junto e nenhum alerta sai. Para detectar queda da máquina, rode o Uptime Kuma em outra VPS ou em outra rede."
        }
      },
      {
        "@type": "Question",
        "name": "Como monitorar um backup ou uma tarefa cron com o Uptime Kuma?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Use um monitor do tipo Push. Ele gera uma URL que o seu script chama com curl ao terminar com sucesso. Se a chamada não chegar dentro do intervalo configurado, o monitor fica fora e o alerta dispara."
        }
      }
    ]
  }
]
```