# Sachez quand quelque chose se passe à la maison.

> Recevez les alertes de votre homelab sur votre téléphone. Connectez Uptime Kuma, Home Assistant ou un script bash à Pocket Alert avec un simple curl. Sans redirection de ports, gratuit pour un usage personnel.

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

Dernière mise à jour : 2026-08-11

Surveillez votre homelab de n’importe où : Home Assistant, Uptime Kuma ou tout serveur auto-hébergé peut joindre votre téléphone sans jamais exposer un port. L’offre gratuite couvre un laboratoire personnel.

## Trois étapes pour les alertes de votre homelab

1. **Récupérez l’URL ou la CLI** — Copiez l’URL de webhook de votre application, ou installez la CLI Pocket Alert sur votre serveur.
2. **Branchez vos serveurs** — Enchaînez un curl à la fin d’un script, transmettez un webhook depuis Kuma ou Home Assistant, ou utilisez systemd OnFailure.
3. **Surveillez de n’importe où** — Déclenchez un événement et votre téléphone vibre, même derrière un NAT et sans aucun port exposé.

## La supervision de votre homelab

L’auto-hébergement mérite toujours une surveillance attentive. Reliez votre homelab à votre téléphone et supprimez la facture de supervision cloud.

- **Compatible avec votre infrastructure** — Uptime Kuma, Home Assistant, Proxmox, Pi-hole et les applications *arr transmettent un webhook ou enchaînent un curl.
- **Aucun port exposé** — HTTPS sortant uniquement. Aucune IP publique requise, et le fonctionnement reste normal derrière un NAT ou un VPN.
- **Canaux par machine** — Une application par machine : les alertes du NAS, de Proxmox et de Pi-hole restent dans leurs propres canaux.
- **Scriptable partout** — Appelez-le depuis bash, une unité systemd, un healthcheck Docker ou une tâche cron.
- **Gratuit pour un usage personnel** — L’offre gratuite couvre un homelab personnel, sans tarification par siège.
- **Livraison en moins d’une seconde** — La livraison prend moins d’une seconde : un problème à la maison vous parvient où que vous soyez.

## Connectez votre homelab

### 1. Depuis un script bash ou cron (CLI)

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

Ou passez la CLI et envoyez directement les messages via curl vers l’API depuis n’importe quel 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. Depuis 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. Depuis Uptime Kuma (webhook)

Créez un webhook sur la page [Webhooks](https://pocketalert.app/fr/webhooks) et copiez son URL de réception, par exemple `https://p4a.me/wh/1234abcd`. Dans Uptime Kuma, ajoutez une notification de type **webhook** pointant vers cette URL, puis mappez la charge utile de Kuma avec un modèle GJSON, par exemple `%monitor.name% is %heartbeat.status%`.

Tout fonctionne en HTTPS sortant : la redirection de ports n’entre jamais en jeu. Consultez la [documentation](https://info.pocketalert.app/getting-started.html).

## FAQ

### Comment envoyer une alerte depuis mon homelab ?

Tout serveur auto-hébergé capable d’envoyer une requête HTTP peut vous joindre. Enchaînez un curl à la fin d’un script, transmettez un webhook depuis Uptime Kuma ou Home Assistant, ou appelez la CLI depuis une unité systemd. L’alerte atteint votre téléphone, quel que soit l’endroit où tourne le serveur.

### Est-ce compatible avec les applications auto-hébergées ?

Oui. Pocket Alert fonctionne avec Uptime Kuma, Home Assistant, les hooks Proxmox, Pi-hole, les applications *arr et de simples scripts bash. Si l’outil peut envoyer un POST en JSON, cela fonctionne.

### Dois-je exposer mon serveur ?

Ni IP publique, ni redirection de ports. Votre serveur ouvre une requête HTTPS sortante vers Pocket Alert, ce qui fonctionne derrière un NAT, un routeur domestique ou un VPN.

### Puis-je séparer mes différentes machines ?

Créez une application par machine ou par service. Les alertes de votre NAS, de Proxmox et de Pi-hole arrivent chacune dans un canal distinct et restent faciles à distinguer.

### Existe-t-il une option gratuite pour un usage personnel ?

Oui. L’offre gratuite couvre un homelab personnel. Pas de tarification par siège, et pas de contrat de supervision d’entreprise pour être prévenu qu’un NAS va mal.

### Une alerte peut-elle percer le mode Ne pas déranger la nuit ?

Oui. Envoyée avec le niveau critical, l’alerte est publiée sur Android dans un canal de notification dédié qui contourne le mode Ne pas déranger, et peut même s’afficher en plein écran : vous accordez l’accès au mode Ne pas déranger une seule fois. Sur iPhone, les alertes high et critical arrivent comme notifications sensibles au temps, qui percent les modes Concentration. Le son critical complet, qui passe outre le bouton silencieux, sera déployé au fil de l’obtention de l’autorisation auprès d’Apple. Sur l’offre gratuite, critical est livré comme high : toujours instantané, mais sans contournement du mode Ne pas déranger.
