Installer Uptime Kuma et être prévenu quand un site tombe
Installer Uptime Kuma, créer ses premières sondes (site, mot-clé, certificat), recevoir les alertes sur Discord ou Telegram et publier une page de statut.
Uptime Kuma vérifie en continu que vos sites répondent et vous prévient à la seconde où l’un d’eux tombe. C’est le premier outil de surveillance à installer, dès que vous hébergez quelque chose.
Installer
Dans Mon serveur, ajoutez Uptime Kuma (150 Mo de RAM). Adresse proposée :
status.mondomaine.fr.
Tout de suite après l’installation, ouvrez l’adresse et créez le compte administrateur : tant qu’il n’existe pas, le premier visiteur peut le créer.
Uptime Kuma 2 commence par demander quelle base de données utiliser : choisissez SQLite (intégrée, rien à installer, largement suffisante). Il prépare la base en quelques secondes, puis affiche la création du compte administrateur. Tant que ces deux étapes ne sont pas faites, son dossier de données reste vide : la sauvegarde de la nuit n’a encore rien à copier.
Créer sa première sonde
Ajouter une nouvelle sonde, puis :
| Champ | Valeur |
|---|---|
| Type de sonde | HTTP(s) |
| Nom convivial | Mon site |
| URL | https://mondomaine.fr |
| Intervalle | 60 secondes |
| Nouvelles tentatives | 2 (évite les fausses alertes sur un raté isolé) |
Faites-en une par site et par application importante (Vaultwarden, Nextcloud…).
Les sondes plus malignes
- HTTP(s) - Mot-clé : vérifie qu’un mot précis est sur la page. Un site qui répond « 200 » avec une page d’erreur sera détecté.
- Expiration du certificat : dans les options avancées d’une sonde HTTPS, cochez la notification d’expiration. Si le renouvellement automatique casse, vous le saurez 14 jours avant.
- Port TCP : pour un service qui n’est pas un site web (SSH sur le port 22, par exemple).
- Ping : la machine répond-elle ?
Recevoir les alertes
Paramètres → Notifications → Configurer une notification. Les plus simples :
- Discord : dans votre serveur Discord, Paramètres du salon → Intégrations → Webhooks → Nouveau webhook, copiez l’URL et collez-la dans Uptime Kuma.
- Telegram : créez un bot avec @BotFather, récupérez son jeton et votre identifiant de discussion.
- ntfy : si vous avez votre propre ntfy, indiquez son adresse et un sujet.
Cliquez sur Tester avant d’enregistrer, puis cochez Activé par défaut et Appliquer à toutes les sondes existantes.
La page de statut
Pages de statut → Nouvelle page de statut : une page publique qui montre si vos services fonctionnent, pratique pour votre famille ou vos utilisateurs. Choisissez les sondes à afficher ; les adresses internes restent cachées.
Le piège : surveiller un serveur depuis lui-même
Si Uptime Kuma tourne sur le serveur qu’il surveille et que ce serveur tombe, Uptime Kuma tombe avec lui… et ne vous prévient de rien. Il voit les pannes d’une application, pas celle du serveur entier.
Deux solutions :
- installer Uptime Kuma sur une autre machine (un Raspberry Pi à la maison, un second petit VPS) ;
- ou ajouter une surveillance externe gratuite (UptimeRobot, Better Stack) pour la seule page d’Uptime Kuma.
Le guide surveiller son serveur va plus loin, avec un watchdog qui surveille aussi le disque, la mémoire et les sauvegardes.
Quand une alerte tombe
- Ouvrez la sonde : le message d’erreur indique la cause (délai dépassé, code 502, certificat…).
- Regardez les logs de l’application concernée et collez-les dans le décodeur d’erreurs.
- Suivez la méthode diagnostiquer une application qui ne marche pas.
Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.