3 minutes
uptime kuma
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
- Installer Docker et Docker Compose :
sudo apt update sudo apt install docker.io docker-compose
- Cloner le dépôt Uptime Kuma :
git clone https://github.com/louislam/uptime-kuma.git cd uptime-kuma
- 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
- 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
- Connectez-vous à l’interface web.
- Cliquez sur “Add Monitor”.
- 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
- 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
- Allez dans “Settings” > “Notifications”.
- Sélectionnez “Mobile Free” comme type de notification.
- Entrez vos informations d’identification Free Mobile.
- Configurez les alertes selon vos préférences (par exemple, en cas de panne ou de reprise).
- Enregistrez les paramètres.
- Testez la configuration en cliquant sur “Send Test Notification”.
Configuration de Home Assistant
- Installez le plugin Uptime Kuma dans Home Assistant.
- Allez dans “Configuration” > “Integrations”.
- Cliquez sur “Add Integration” et recherchez “Uptime Kuma”.
- Entrez l’URL de votre instance Uptime Kuma et les informations d’identification si nécessaire.
- Configurez les entités et les automatisations selon vos besoins.
- Enregistrez et testez l’intégration pour vous assurer que les notifications fonctionnent correctement.
- 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 :
- Arrêtez le conteneur :
docker-compose down
- Tirez la dernière image :
docker-compose pull
- 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.