# Saiba quando algo acontece em casa.

> Receba alertas do seu homelab no celular. Conecte Uptime Kuma, Home Assistant ou um script bash ao Pocket Alert com um único curl. Sem port-forwarding, gratuito para uso hobby.

<!-- source: https://pocketalert.app/pt/use-cases/homelab-alerts -->

Última atualização: 2026-08-11

Monitore seu homelab de qualquer lugar. Home Assistant, Uptime Kuma ou qualquer servidor auto-hospedado pode falar com o seu celular sem nunca expor uma porta. O plano gratuito cobre um laboratório pessoal.

## Três passos para alertas no homelab

1. **Obtenha a URL ou a CLI** — Copie a URL de webhook do seu aplicativo ou instale a CLI do Pocket Alert no seu servidor.
2. **Conecte seus servidores** — Encadeie um curl em um script, encaminhe um webhook do Kuma ou do Home Assistant, ou use o OnFailure do systemd.
3. **Monitore de qualquer lugar** — Dispare um evento e seu celular vibra, mesmo atrás de NAT e sem portas expostas.

## Monitoramento para o seu homelab

Auto-hospedar ainda exige atenção. Conecte seu homelab ao celular e deixe de pagar a conta de monitoramento na nuvem.

- **Funciona com a sua stack** — Uptime Kuma, Home Assistant, Proxmox, Pi-hole e os aplicativos *arr encaminham um webhook ou encadeiam um curl.
- **Nenhuma porta exposta** — Somente HTTPS de saída. Não é preciso IP público, e funciona sem problemas atrás de NAT ou VPN.
- **Canais por máquina** — Um aplicativo por máquina mantém os alertas do NAS, do Proxmox e do Pi-hole em canais próprios.
- **Automatizável em qualquer lugar** — Chame a partir de bash, de uma unidade systemd, de um healthcheck do Docker ou de uma tarefa cron.
- **Gratuito para uso pessoal** — O plano gratuito cobre um homelab pessoal, sem cobrança por usuário.
- **Entrega em menos de um segundo** — A entrega leva menos de um segundo, então um problema em casa chega até você onde quer que esteja.

## Conecte seu homelab

### 1. A partir de um script bash ou cron (CLI)

```
pocketalert auth YOUR_API_KEY
pocketalert send -t "NAS · disk degraded" -m "pool tank · drive 2 FAULTED"
```

Ou dispense a CLI e faça curl na API de mensagens diretamente de qualquer script:

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Proxmox backup failed","message":"vzdump job on pve1 exited 1","level":"high"}'
```

### 2. A partir do Home Assistant

```
rest_command:
  pocketalert:
    url: "https://api.pocketalert.app/v1/messages"
    method: POST
    headers:
      Token: "YOUR_API_KEY"
    content_type: "application/json"
    payload: '{"title":"{{ title }}","message":"{{ message }}"}'
```

### 3. A partir do Uptime Kuma (webhook)

Crie um webhook na página [Webhooks](https://pocketalert.app/pt/webhooks) e copie a URL de recebimento, por exemplo `https://p4a.me/wh/1234abcd`. No Uptime Kuma, adicione uma notificação do tipo **webhook** apontando para essa URL e, em seguida, mapeie o payload do Kuma com um template GJSON, como `%monitor.name% is %heartbeat.status%`.

Tudo funciona por HTTPS de saída, então o redirecionamento de portas não entra em cena. Veja a [documentação](https://info.pocketalert.app/getting-started.html).

## Perguntas frequentes

### Como envio alertas do meu homelab?

Qualquer servidor auto-hospedado que consiga fazer uma requisição HTTP consegue falar com você. Encadeie um curl em um script, encaminhe um webhook do Uptime Kuma ou do Home Assistant, ou chame a CLI a partir de uma unidade systemd. O alerta encontra seu celular não importa onde o servidor esteja rodando.

### Funciona com aplicativos auto-hospedados?

Sim. O Pocket Alert funciona com Uptime Kuma, Home Assistant, hooks do Proxmox, Pi-hole, os aplicativos *arr e scripts bash simples. Se ele consegue fazer um POST de JSON, funciona.

### Preciso expor meu servidor?

Não é preciso IP público nem redirecionamento de portas. Seu servidor abre uma requisição HTTPS de saída para o Pocket Alert, o que significa que funciona atrás de NAT, em um roteador doméstico ou em uma VPN.

### Consigo separar minhas diferentes máquinas?

Crie um aplicativo por máquina ou serviço. Os alertas do seu NAS, do Proxmox e do Pi-hole chegam cada um em um canal separado e continuam fáceis de distinguir.

### Existe opção gratuita para uso pessoal?

Sim. O plano gratuito cobre um homelab pessoal. Não há cobrança por usuário, e você não precisa de um contrato de monitoramento corporativo só para ser avisado de que o NAS está com problemas.

### Um alerta consegue furar o Não perturbe à noite?

Sim. Envie com o nível critical e, no Android, ele é publicado em um canal de notificação dedicado que ignora o Não perturbe e pode até aparecer em tela cheia. Você concede o acesso ao Não perturbe uma única vez. No iPhone, os níveis high e critical chegam como notificações sensíveis ao tempo, que atravessam os modos Foco. O som crítico completo, que sobrepõe o botão de silêncio, está sendo liberado conforme a Apple concede a permissão. No plano gratuito, critical é entregue como high: ainda instantâneo, mas sem a ignorância do Não perturbe.
