# Scopri quando succede qualcosa a casa.

> Ricevi sul telefono gli avvisi del tuo homelab. Collega Uptime Kuma, Home Assistant o uno script bash a Pocket Alert con un solo curl. Niente port forwarding, gratis per uso hobbistico.

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

Ultimo aggiornamento: 2026-08-11

Tieni d'occhio il tuo homelab ovunque tu sia: Home Assistant, Uptime Kuma o qualsiasi server self-hosted può raggiungere il tuo telefono senza esporre alcuna porta. Il piano gratuito copre un laboratorio personale.

## Tre passaggi per le notifiche del homelab

1. **Ottieni l'URL o la CLI** — Copia l'URL webhook della tua applicazione oppure installa la CLI di Pocket Alert sul tuo server.
2. **Collega i tuoi server** — Aggiungi un curl a uno script, inoltra un webhook da Kuma o Home Assistant, oppure usa OnFailure di systemd.
3. **Monitora da ovunque** — Genera un evento e il telefono vibra, anche da dietro NAT e senza porte esposte.

## Monitoraggio per il tuo homelab

Self-hosting merita comunque attenzione. Collega il tuo homelab al telefono ed elimina la bolletta del monitoraggio cloud.

- **Funziona con il tuo stack** — Uptime Kuma, Home Assistant, Proxmox, Pi-hole e le app *arr inoltrano un webhook o concatenano un curl.
- **Nessuna porta esposta** — Solo HTTPS in uscita. Non serve un IP pubblico e funziona senza problemi dietro NAT o VPN.
- **Canali per macchina** — Un'app per macchina tiene le notifiche di NAS, Proxmox e Pi-hole nei rispettivi canali.
- **Automatizzabile ovunque** — Richiamala da bash, un'unità systemd, un healthcheck Docker o un cron job.
- **Gratis per uso hobbistico** — Il piano gratuito copre un homelab personale, senza prezzi per postazione.
- **Consegna in meno di un secondo** — La consegna richiede meno di un secondo, quindi un problema a casa ti raggiunge ovunque tu sia.

## Collega il tuo homelab

### 1. Da uno script bash o cron (CLI)

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

Oppure salta la CLI e invia una richiesta curl all'API dei messaggi direttamente da qualsiasi 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. Da 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. Da Uptime Kuma (webhook)

Crea un webhook nella pagina [Webhook](https://pocketalert.app/it/webhooks) e copia il suo URL di ricezione, ad esempio `https://p4a.me/wh/1234abcd`. In Uptime Kuma aggiungi una notifica di tipo **webhook** che punti a quell'URL, poi mappa il payload di Kuma con un template GJSON come `%monitor.name% is %heartbeat.status%`.

Tutto avviene tramite HTTPS in uscita, quindi il port forwarding non entra mai in gioco. Consulta la [documentazione](https://info.pocketalert.app/getting-started.html).

## FAQ

### Come invio notifiche dal mio homelab?

Qualsiasi server self-hosted in grado di fare una richiesta HTTP può raggiungerti. Aggiungi un curl a uno script, inoltra un webhook da Uptime Kuma o Home Assistant, oppure chiama la CLI da un'unità systemd. La notifica raggiunge il tuo telefono indipendentemente da dove gira il server.

### Funziona con le app self-hosted?

Sì. Pocket Alert funziona con Uptime Kuma, Home Assistant, gli hook di Proxmox, Pi-hole, le app *arr e semplici script bash. Se può inviare un POST JSON, funziona.

### Devo esporre il mio server?

No, non servono IP pubblico né port forwarding. Il tuo server apre una richiesta HTTPS in uscita verso Pocket Alert, quindi funziona anche dietro NAT, con un router domestico o con una VPN.

### Posso separare le mie diverse macchine?

Crea un'applicazione per ogni macchina o servizio. Le notifiche di NAS, Proxmox e Pi-hole finiscono ciascuna in un canale separato e restano facili da distinguere.

### Esiste un'opzione gratuita per uso hobbistico?

Sì. Il piano gratuito copre un homelab personale. Nessun prezzo per postazione e nessun contratto di monitoraggio enterprise per sapere che il NAS ha un problema.

### Un'notifica può superare Non disturbare di notte?

Sì. Inviala con livello critical e su Android viene pubblicata su un canale di notifica dedicato che ignora Non disturbare e può persino essere mostrata a schermo intero: concedi l'accesso a Non disturbare una sola volta. Su iPhone, le notifiche high e critical arrivano come notifiche time-sensitive che superano le modalità Full immersion; il suono critical completo, che aggira l'interruttore della suoneria, sarà disponibile man mano che Apple concederà l'autorizzazione. Con il piano gratuito, critical viene consegnata come high: resta istantanea, ma senza l'esclusione da Non disturbare.
