Sommaire10 parties
Uptime Kuma est un outil de monitoring auto-hébergé, open source, qui vérifie à intervalles réguliers que tes sites web et tes services répondent. Il tourne sur ton propre serveur, offre une interface web et t’envoie une alerte quand quelque chose ne répond plus. Cet article détaille ce qu’il surveille, comment l’installer et où en est le projet.
En bref
- Surveille HTTP(s), TCP, ping, DNS, Websocket et conteneurs Docker
- Vérifications possibles toutes les 20 secondes
- Alertes via Telegram, Discord, Slack, e-mail et plus de 90 services
- Plusieurs pages de statut, associables à des domaines
- Installation par Docker Compose ou sans Docker, licence MIT
Qu’est-ce qu’Uptime Kuma ?
Uptime Kuma est un outil de supervision que tu installes toi-même. Son rôle : tester régulièrement si un site, un serveur ou un service répond, garder l’historique de ces tests et te prévenir en cas de panne. Il est écrit par louislam et publié sous licence MIT.
Le projet est né d’un manque. Son auteur cherchait un outil auto-hébergé comparable à Uptime Robot et peinait à en trouver un adapté. L’un des plus proches, statping, n’était selon lui ni stable ni encore maintenu. Il voulait aussi construire une interface soignée, apprendre Vue 3 et vite.js, et tester le WebSocket avec une application monopage plutôt qu’une API REST.
Ce que surveille Uptime Kuma
La liste des types de vérifications est large. Au-delà d’une simple page web, l’outil peut tester un port, interroger un enregistrement DNS ou surveiller un conteneur.
Les vérifications peuvent être lancées toutes les 20 secondes. L’interface affiche aussi un graphique de ping et des informations sur les certificats.
- HTTP(s), avec variantes par mot-clé ou par requête sur du JSON
- TCP, Websocket et ping
- Enregistrements DNS
- Moniteurs de type « push »
- Serveurs de jeu Steam
- Conteneurs Docker
Alertes et pages de statut
Quand une vérification échoue, Uptime Kuma envoie une notification. Le README cite Telegram, Discord, Gotify, Slack, Pushover et l’e-mail (SMTP), et indique plus de 90 services au total.
L’outil permet aussi de créer plusieurs pages de statut, c’est-à-dire des pages publiques qui montrent l’état de tes services, et de les associer à des domaines précis. Le README mentionne également la prise en charge d’un proxy, l’authentification à deux facteurs et une interface disponible en plusieurs langues.
Installer Uptime Kuma avec Docker
La méthode décrite en premier est Docker Compose. Quatre commandes suffisent : elles créent un dossier, récupèrent le fichier de configuration et lancent le service. Uptime Kuma écoute ensuite sur toutes les interfaces réseau, par exemple sur le port 3001.
Une alternative est la commande docker run. Pour limiter l’accès à la machine locale, le README indique de remplacer le mapping de port par -p 127.0.0.1:3001:3001. Un avertissement : les systèmes de fichiers comme NFS ne sont pas pris en charge, il faut utiliser un répertoire local ou un volume.
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2Installer Uptime Kuma sans Docker
Sans Docker, il faut Node.js 20.4 ou plus, Git et pm2, un outil qui maintient le programme actif en arrière-plan. Le README liste les plateformes prises en charge : les grandes distributions Linux (Debian, Ubuntu, Fedora, ArchLinux) et Windows 10 (x64) ou Windows Server 2012 R2 (x64) et plus. FreeBSD, OpenBSD, NetBSD, Replit et Heroku sont marqués comme non pris en charge.
Pour les options avancées, comme l’accès derrière un reverse proxy, le README renvoie au wiki du projet. Il prévient aussi que le premier résultat Google, uptimekuma.co, n’est pas le site officiel et recommande de suivre le guide du dépôt GitHub.
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup
node server/server.js
pm2 start server/server.js --name uptime-kumaOù en est le projet
Au 14 novembre 2026, le dépôt compte 94 101 étoiles, 8 734 copies (forks) et 1 161 contributeurs. Il a été créé le 3 juillet 2021 et affiche 854 tickets et demandes de fusion ouverts. Le code est écrit à 51 % en JavaScript, 36 % en Vue et 11 % en TypeScript.
La dernière version, la 2.5.11, est parue le 12 novembre 2026. Les trois dernières versions (2.5.9, 2.5.10 et 2.5.11) corrigent surtout des failles de sécurité : mise à jour de dépendances, correctif d’une faille d’exécution de code réservée aux administrateurs, empoisonnement du cache RSS. La 2.5.10 met à jour Node.js dans l’image Docker ; pour une installation sans Docker, les notes de version recommandent de mettre à jour Node.js soi-même. Ces versions corrigent aussi des bugs, notamment la réinitialisation du mot de passe avec MariaDB intégrée.
L’auteur affecte les demandes à des jalons (milestones) pour la suite. Il précise ne pas répondre aux questions techniques par e-mail : l’aide passe par les tickets GitHub ou le subreddit du projet.
Quelques repères
- Auto-hébergement : Installer et faire tourner un logiciel sur son propre serveur ou son propre ordinateur, plutôt que d’utiliser un service en ligne géré par une entreprise. Tu gardes la main sur les données, mais tu assures aussi la maintenance.
- Conteneur : Un paquet qui regroupe un programme et tout ce dont il a besoin pour fonctionner, isolé du reste de la machine. Il se déplace facilement d’un serveur à un autre.
- Reverse proxy : Un serveur placé devant une application, qui reçoit les requêtes à sa place et les lui transmet. Il sert souvent à gérer le nom de domaine et le chiffrement des connexions.
Questions fréquentes
Uptime Kuma est-il une alternative à Uptime Robot ?
Oui, dans l’esprit. L’auteur explique avoir cherché un outil auto-hébergé comparable à Uptime Robot avant de créer Uptime Kuma, faute d’en trouver un adapté.
Comment être alerté quand un site tombe avec Uptime Kuma ?
Uptime Kuma envoie une notification quand une vérification échoue. Il prend en charge Telegram, Discord, Gotify, Slack, Pushover, l’e-mail (SMTP) et plus de 90 services au total.
Uptime Kuma peut-il surveiller des conteneurs Docker ?
Oui, les conteneurs Docker font partie des types de surveillance listés. Uptime Kuma gère aussi HTTP(s), TCP, ping, DNS, Websocket, les moniteurs push et les serveurs de jeu Steam.
Peut-on essayer Uptime Kuma sans l’installer ?
Oui, le README propose une démo en ligne hébergée à Francfort. Elle est temporaire : toutes les données sont supprimées au bout de 10 minutes.
À retenir
Uptime Kuma réunit dans une interface web la surveillance de sites, de ports, de DNS et de conteneurs, avec alertes et pages de statut, sur un serveur que tu contrôles. Le projet est sous licence MIT, très suivi sur GitHub et publie régulièrement des versions, dont plusieurs récentes consacrées à la sécurité.
