Description

Uptime Kuma est un outil de surveillance de la disponibilité des services web. Il permet de vérifier si vos sites web ou services sont en ligne et de recevoir des notifications en cas de panne. Il est facile à installer et à configurer, et il offre une interface utilisateur conviviale pour suivre l’état de vos services.

Installation

Pré-requis

  • Docker
  • Docker Compose
  • Un serveur Ubuntu ou tout autre système compatible

Installation avec Docker

  1. Installer Docker et Docker Compose :
    sudo apt update
    sudo apt install docker.io docker-compose
    
  2. Cloner le dépôt Uptime Kuma :
    git clone https://github.com/louislam/uptime-kuma.git
    cd uptime-kuma
    
  3. Créer un fichier docker-compose.yml :
    version: '3'
    services:
      uptime-kuma:
        image: louislam/uptime-kuma
        container_name: uptime-kuma
        restart: always
        ports:
          - "3001:3001"
        volumes:
          - ./data:/app/data
        environment:
          - TZ=Europe/Paris
    
  4. Démarrer Uptime Kuma :
    docker-compose up -d
    

Accéder à l’interface web

Ouvrez votre navigateur et accédez à `http://<votre-ip>:3001`. Vous devriez voir l'interface d'Uptime Kuma.

Configuration

Ajouter un service à surveiller

  1. Connectez-vous à l’interface web.
  2. Cliquez sur “Add Monitor”.
  3. Remplissez les informations nécessaires :
    • Name : Nom du service
    • URL : URL du service à surveiller
    • Type : Type de vérification (HTTP(s), Ping, etc.)
    • Interval : Intervalle de vérification (par exemple, 60 secondes)
    • Timeout : Durée maximale d’attente pour une réponse
    • Alerting : Configurez les alertes si nécessaire
  4. Cliquez sur “Save” pour enregistrer le service.

Notifications

Uptime Kuma peut envoyer des notifications via différents canaux, y compris mobile.free.fr et Home Assistant.

Configuration de mobile.free.fr

  1. Allez dans “Settings” > “Notifications”.
  2. Sélectionnez “Mobile Free” comme type de notification.
  3. Entrez vos informations d’identification Free Mobile.
  4. Configurez les alertes selon vos préférences (par exemple, en cas de panne ou de reprise).
  5. Enregistrez les paramètres.
  6. Testez la configuration en cliquant sur “Send Test Notification”.

Configuration de Home Assistant

  1. Installez le plugin Uptime Kuma dans Home Assistant.
  2. Allez dans “Configuration” > “Integrations”.
  3. Cliquez sur “Add Integration” et recherchez “Uptime Kuma”.
  4. Entrez l’URL de votre instance Uptime Kuma et les informations d’identification si nécessaire.
  5. Configurez les entités et les automatisations selon vos besoins.
  6. Enregistrez et testez l’intégration pour vous assurer que les notifications fonctionnent correctement.
  7. Vous pouvez également créer des automatisations dans Home Assistant pour réagir aux changements d’état des services surveillés par Uptime Kuma.

Mise à jour

Pour mettre à jour Uptime Kuma, suivez ces étapes :

  1. Arrêtez le conteneur :
    docker-compose down
    
  2. Tirez la dernière image :
    docker-compose pull
    
  3. Redémarrez le conteneur :
    docker-compose up -d
    

Sauvegarde des données

Pour sauvegarder les données d’Uptime Kuma, vous pouvez copier le contenu du volume de données vers un emplacement de sauvegarde. Par exemple :

docker cp uptime-kuma:/app/data /path/to/backup

Résolution des problèmes

Conteneur ne démarre pas

Si le conteneur ne démarre pas, vérifiez les journaux avec :

docker logs uptime-kuma

Problèmes de connexion

Si vous ne pouvez pas accéder à l’interface web, assurez-vous que le port 3001 est ouvert et accessible. Vérifiez également les règles de pare-feu sur votre serveur.

Documentation et support

Pour plus d’informations, consultez la documentation officielle

Contributions

Si vous souhaitez contribuer au projet, vous pouvez le faire en ouvrant des issues ou en soumettant des pull requests sur le dépôt GitHub d’Uptime Kuma.