🎯 TUTORIEL PAS À PAS

📊 Mise en place d'Uptime Kuma

📅 Mis à jour : Août 2026 ⏱️ Durée : 15 min 📋 Niveau : Débutant / Intermédiaire 📊 Uptime Kuma 🐳 Docker 📦 Docker Compose

Uptime Kuma est un outil de monitoring de disponibilité auto-hébergé, élégant et facile à utiliser. Il permet de surveiller la disponibilité de vos sites web, serveurs et services, avec des notifications en temps réel et un tableau de bord moderne. Ce tutoriel vous guide pas à pas dans son installation avec Docker Compose.

📌 Prérequis :

Un serveur avec Docker et Docker Compose installés (voir le tutoriel Docker).
Un nom de domaine ou sous-domaine pointant vers l'IP du serveur (optionnel mais recommandé pour HTTPS).
Les ports 3001 (ou un autre) ouverts si vous utilisez un pare-feu.

1 Préparation du projet

Étape 1 – Créer le répertoire du projet

Créez un répertoire dédié pour le projet Uptime Kuma.

$ mkdir -p ~/uptime-kuma && cd ~/uptime-kuma

Étape 2 – Créer le répertoire de données

Créez le dossier qui sera monté comme volume pour persister les données.

$ mkdir -p data

📂 Organisation :

data/ : contient les fichiers de configuration et la base de données SQLite.

2 Création du fichier docker-compose.yml

Étape 1 – Créer le fichier docker-compose.yml

Créez le fichier de composition avec le service Uptime Kuma.

$ nano docker-compose.yml

---
services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: always
    volumes:
      - ./data:/app/data
    ports:
      - "3001:3001"
    environment:
      - UPTIME_KUMA_SERVER_NAME=Uptime Kuma

🔍 Explication :

image: louislam/uptime-kuma:latest : utilise la dernière version officielle.
volumes : persiste les données dans le dossier local ./data.
ports : expose l'interface web sur le port 3001 de l'hôte.
environment : définit le nom affiché dans le navigateur.

3 Démarrage du conteneur

Étape 1 – Lancer le conteneur

$ docker compose up -d

✅ Le conteneur uptime-kuma est démarré.

Étape 2 – Vérifier l'état du conteneur

$ docker compose ps

✅ Le conteneur doit être Up.

Étape 3 – Accéder à l'interface web

Depuis un navigateur, accédez à http://IP_DU_SERVEUR:3001.

http://IP_DU_SERVEUR:3001

✅ La page d'accueil d'Uptime Kuma s'affiche.

4 Configuration initiale d'Uptime Kuma

Étape 1 – Créer un compte administrateur

Lors de la première connexion, vous serez invité à créer un compte administrateur. Renseignez un nom d'utilisateur, un mot de passe et un email.

✅ Le compte administrateur est créé et vous êtes connecté.

Étape 2 – Ajouter votre premier site à surveiller

Cliquez sur le bouton + Ajouter un nouveau moniteur.

Type             : HTTP/HTTPS
Nom              : Mon site
URL              : https://mon-domaine.fr
Intervalle       : 60 secondes
Notification     : (configurer plus tard)

Cliquez sur Enregistrer pour ajouter le moniteur.

✅ Le site est maintenant surveillé.

5 Configuration des notifications

Uptime Kuma peut envoyer des notifications en cas de changement de statut via de nombreux canaux : email, Telegram, Discord, Slack, webhooks, etc.

Étape 1 – Accéder à la configuration des notifications

Dans le menu de gauche, cliquez sur Paramètres (icône ⚙️) puis sur l'onglet Notifications.

Étape 2 – Ajouter un nouveau canal de notification

Cliquez sur Configurer une notification.

Nom                : Mon téléphone
Type               : Telegram / Discord / Email / etc.
(Suivre les instructions spécifiques à chaque service)

💡 Astuce : Pour Telegram, vous aurez besoin d'un botToken et d'un chatId. Suivez les instructions affichées dans l'interface.

Étape 3 – Tester la notification

Une fois le canal configuré, cliquez sur Tester pour vérifier que vous recevez bien le message.

✅ Vous recevez une notification de test.

Étape 4 – Assigner la notification à un moniteur

Modifiez un moniteur existant ou ajoutez-en un nouveau, et sélectionnez le canal de notification dans la section Notifications.

6 (Optionnel) Sécuriser avec HTTPS via Traefik

Pour exposer Uptime Kuma en HTTPS avec un certificat Let's Encrypt, vous pouvez utiliser Traefik comme reverse-proxy. Cette section suppose que vous avez déjà installé Traefik (voir le tutoriel Traefik).

Étape 1 – Ajouter les labels Traefik

Modifiez le service dans docker-compose.yml pour ajouter les labels Traefik.

---
services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: always
    volumes:
      - ./data:/app/data
    ports:
      - "3001:3001"
    environment:
      - UPTIME_KUMA_SERVER_NAME=Uptime Kuma
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.uptime.rule=Host(`uptime.mon-domaine.fr`)"
      - "traefik.http.routers.uptime.entrypoints=websecure"
      - "traefik.http.routers.uptime.tls.certresolver=le"
      - "traefik.http.services.uptime.loadbalancer.server.port=3001"

⚠️ Modifications nécessaires : Remplacez uptime.mon-domaine.fr par votre domaine réel.

Étape 2 – Relancer la stack

$ docker compose down
$ docker compose up -d

Étape 3 – Accéder à Uptime Kuma en HTTPS

https://uptime.mon-domaine.fr

✅ Uptime Kuma est maintenant accessible en HTTPS !

✅ Test de validation

🎉 Installation réussie si :

Le conteneur est Up (docker compose ps).
L'interface web d'Uptime Kuma est accessible sur http://IP:3001.
Vous avez créé un compte administrateur et vous êtes connecté.
Vous avez ajouté un premier moniteur et il s'affiche dans le tableau de bord.
(Optionnel) Uptime Kuma est accessible en HTTPS.

📚 Ressources complémentaires

← Retour au portail

BTS SIO – Lycée NDLP Avranches – Tutoriel Uptime Kuma v1.0