Uptime Kuma

Présentation de Uptime Kuma

Ce que vous pouvez faire avec Uptime Kuma

• Nombreux types de moniteurs

  HTTP(S), mot-clé dans une page, TCP, ping, DNS, conteneur Docker et d'autres. Vous choisissez l'intervalle de contrôle et le nombre d'échecs avant alerte.

• Alertes sur vos canaux habituels

  Telegram, Discord, Slack, e-mail SMTP, webhook et de nombreux autres services de notification sont disponibles depuis l'interface, sans plugin à installer.

• Pages de statut publiques

  Vous publiez une page d'état de vos services pour vos clients ou votre équipe, avec votre propre domaine si vous le souhaitez.

• Suivi des certificats TLS

  Uptime Kuma lit la date d'expiration des certificats des sites HTTPS supervisés et peut vous prévenir avant qu'ils n'expirent.

• Docker et Caddy préinstallés

  Deux conteneurs avec redémarrage automatique (restart: always), décrits dans un fichier docker-compose.yml que vous pouvez modifier et versionner.

• Données dans un volume dédié

  La configuration et l'historique des moniteurs sont stockés dans le volume Docker kuma_data, ce qui simplifie sauvegardes et mises à jour.

Démarrer avec Uptime Kuma

De la commande à la mise en production, en quelques minutes.

1. 1

   Commander le VPS avec Uptime Kuma

   Sur le formulaire de commande, choisissez un VPS Linux (Paris ou Francfort) avec Debian 12, Debian 13 ou Ubuntu 20.04, 22.04, 24.04. Dans l'onglet « Applications », cochez Uptime Kuma.

2. 2

   Attendre la livraison et ouvrir l'interface

   Une fois le serveur livré, l'installation tourne en arrière-plan quelques minutes (téléchargement de Docker et des images). Ouvrez ensuite l'URL ci-dessous. Le navigateur affiche un avertissement, car le certificat est auto-signé : acceptez l'exception pour continuer.

   Bash
   1https://SERVER_IP:443
   2
   3# Vérifier l'état des conteneurs en SSH :
   4ssh root@SERVER_IP
   5cd /opt/uptime-kuma && docker compose ps

3. 3

   Créer le compte admin et le premier moniteur

   Au premier accès, Uptime Kuma vous demande de créer l'utilisateur administrateur. Ajoutez ensuite un moniteur (par exemple HTTP(S) sur votre site) et configurez un canal de notification pour recevoir les alertes.

4. 4

   Sécuriser pour la production

   Pointez un enregistrement DNS A de YOUR_DOMAIN vers SERVER_IP, puis remplacez l'adresse du Caddyfile par votre domaine : Caddy obtiendra un certificat reconnu. Les ports 80 et 443 doivent rester ouverts, et le port 22 limité à vos IP si possible.

   Bash
   1cd /opt/uptime-kuma
   2nano Caddyfile
   3# YOUR_DOMAIN {
   4#   reverse_proxy 127.0.0.1:3001
   5# }
   6docker compose restart caddy

Cas d’usage de Uptime Kuma

• Surveiller vos sites et API

  Un moniteur HTTP par site ou par endpoint critique, avec alerte Telegram ou e-mail dès que le code de réponse sort de la plage attendue.

• Page de statut pour vos clients

  Une agence ou un éditeur SaaS publie l'état de ses services sur une page dédiée, ce qui évite de répondre à chaque question par message.

• Contrôler serveurs et ports internes

  Ping sur vos machines, TCP sur une base de données ou un service SSH, vérification d'un conteneur Docker : une vue unique de l'infrastructure.

• Prévenir les expirations de certificats

  Vous suivez la date d'expiration des certificats de vos domaines et recevez une alerte avant qu'un renouvellement raté ne coupe un site.

Questions fréquentes sur Uptime Kuma

En savoir plus sur Uptime Kuma

Bash
1cd /opt/uptime-kuma
2docker compose stop uptime-kuma
3docker volume ls | grep kuma_data
4docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \
5  tar czf /backup/kuma-backup.tar.gz -C /data .
6docker compose start uptime-kuma

Bash
1cd /opt/uptime-kuma
2docker compose pull
3docker compose up -d