Commencer
Toutes les applications VPS
Supervision

Uptime Kuma : la surveillance de disponibilité sur votre propre serveur

Un outil de surveillance auto-hébergé qui vérifie vos sites et services chaque minute et vous prévient dès que l'un d'eux ne répond plus.

Commander un serveur avec Uptime Kuma Voir les offres VPS

À propos de Uptime Kuma

Uptime Kuma est un outil de surveillance open source lancé par le développeur Louis Lam, devenu l'un des projets auto-hébergés les plus étoilés sur GitHub. Il vérifie que tout répond : sites en HTTP(S), mots-clés sur une page, ports TCP, ping, enregistrements DNS, bases de données et bien plus.

Lorsqu'une vérification échoue, il envoie une notification par l'un des dizaines de canaux pris en charge, dont Telegram, Discord, Slack, l'e-mail et les webhooks. Il suit aussi les temps de réponse, prévient avant l'expiration des certificats TLS et permet de créer des pages de statut publiques pour vos clients.

On l'auto-héberge parce qu'il est léger, gratuit et doté d'une interface claire qui se configure en quelques minutes. Le faire tourner sur un serveur séparé est le point essentiel : un outil de surveillance installé sur la même machine que votre site ne peut pas vous prévenir quand cette machine tombe.

À quoi ça sert

Des alertes quand un site tombe

Vérifiez votre site et votre API chaque minute et recevez un message Telegram ou un e-mail dès qu'ils ne répondent plus.

Alertes d'expiration de certificat

Soyez prévenu plusieurs jours avant l'expiration d'un certificat HTTPS, plutôt que de l'apprendre par vos clients.

Une page de statut publique

Montrez à vos clients l'état actuel de vos services sur une page que vous contrôlez.

Après la commande

Le premier démarrage du serveur installe Uptime Kuma et ouvre le port 3001 dans le pare-feu : l'outil est accessible à l'adresse http://adresse-de-votre-serveur:3001/. Lors de la première visite, vous créez le compte administrateur : ouvrez donc l'adresse dès que le serveur est prêt. Ajoutez ensuite votre première sonde et connectez un canal de notification.

Où l'installer

Uptime Kuma effectue ses vérifications depuis l'endroit où il tourne. Un outil de surveillance installé sur le même serveur que les services qu'il surveille tombe en même temps qu'eux et ne peut pas vous prévenir : gardez-le sur un serveur distinct de ce qu'il surveille.

Votre propre nom de domaine et HTTPS pour Uptime Kuma

Par défaut, Uptime Kuma répond sur l'adresse IP du serveur en HTTP simple. Pour lui donner un nom comme status.example.com avec un certificat, créez dans votre DNS un enregistrement A pour ce nom qui pointe vers l'adresse IPv4 du serveur, puis placez Caddy devant : Caddy obtient tout seul un certificat Let's Encrypt gratuit et le renouvelle. Les commandes ci-dessous concernent Ubuntu 24.04, le système de nos serveurs d'applications.

Dans le panel, ouvrez les ports TCP 80 et 443 dans le pare-feu du serveur : Caddy en a besoin pour obtenir le certificat Let's Encrypt et servir le site.

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
    reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddy

Avec un nom de domaine devant, les pages de statut d'Uptime Kuma peuvent être partagées avec vos clients : créez une page de statut, choisissez les sondes qu'elle affiche et communiquez l'adresse https://status.example.com/status/votre-page. Vous pouvez aussi rattacher le nom de domaine directement à une page de statut dans ses paramètres.

Une fois le nom de domaine opérationnel, plus personne n'a besoin du port 3001 brut : dans /opt/uptime-kuma/compose.yml, remplacez "3001:…" par "127.0.0.1:3001:…", lancez docker compose up -d et retirez le port 3001 du pare-feu. Uptime Kuma n'est alors accessible qu'en HTTPS.

Mettre à jour Uptime Kuma

Les images de /opt/uptime-kuma/compose.yml sont figées sur des versions précises : un simple docker compose pull télécharge donc à nouveau la même version. Pour mettre à jour, remplacez la version dans la ligne image: par celle que vous voulez (lisez d'abord les notes de version), puis téléchargez les images et recréez les conteneurs. Les données se trouvent dans des volumes Docker et sont conservées.

cd /opt/uptime-kuma
nano compose.yml        # the new version in the image: line
docker compose pull
docker compose up -d

Sauvegarder Uptime Kuma

Dans le panel, vous pouvez activer des sauvegardes quotidiennes de tout le serveur (+20 % du prix de l'offre, les 7 dernières copies sont conservées) et restaurer le serveur à partir de n'importe laquelle d'entre elles. Une copie des données de l'application dans un fichier reste utile : elle peut être déplacée vers un autre serveur ou restaurée sans revenir en arrière sur tout le reste.

Les sondes, les réglages de notification et l'historique des vérifications se trouvent dans le volume uptime-kuma_uptime_kuma (/app/data). Arrêtez l'application un instant pour que le fichier de base de données soit copié dans un état cohérent :

cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
  tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start

Comment ça marche

  1. Choisissez Uptime Kuma sur la page de commande du serveur et prenez une offre avec assez de mémoire.
  2. L'application est installée sur le serveur au premier démarrage, généralement en quelques minutes.
  3. Ouvrez le serveur dans votre panel : l'adresse et les identifiants de connexion s'y trouvent.

Questions sur Uptime Kuma

Oui. Uptime Kuma est léger : 1 Go de mémoire et 20 Go de disque constituent le minimum et gèrent confortablement des dizaines de sondes. Pour des centaines de sondes à intervalles courts, 2 Go sont préférables.
De préférence, non. S'ils partagent un serveur et que celui-ci tombe en panne, l'outil de surveillance tombe aussi et aucune alerte n'est envoyée. Un petit serveur séparé est la configuration fiable.
Oui. Une petite offre ARM lui convient aussi bien qu'une offre x86.
Par les canaux de notification que vous configurez dans Uptime Kuma : Telegram, e-mail via SMTP, Slack, Discord, webhooks et bien d'autres. Ajoutez un canal une fois, puis rattachez-le aux sondes.
La première personne qui ouvre l'adresse crée le compte administrateur : ouvrez donc http://adresse-de-votre-serveur:3001/ dès que le serveur est prêt.

Autres applications : Supervision