<!--
  canonical-url: https://www.avonture.be/fr/blog/docker_uptime_kuma
  published:     2023-12-05
  This is a static plain-Markdown mirror generated at build time.
  Visit the canonical URL above for the fully rendered page, with images and interactive components.
-->

# Outil de monitoring auto-hébergé

> Découvrez comment installer facilement Uptime Kuma, un outil de monitoring de sites web gratuit et auto-hébergé, avec une simple commande Docker. Suivez la disponibilité de vos sites, assurez la persistance des données et configurez les notifications.

---
![Outil de monitoring auto-hébergé](/img/v2/docker_playing_with_app.webp)

**TL;DR**

Cet article montre comment auto-héberger Uptime Kuma, un dashboard gratuit de monitoring de sites web, avec une seule commande `docker run` (en montant un volume pour conserver les sites surveillés entre les redémarrages), puis comment configurer les vérifications site par site et les notifications (par exemple via Mattermost ou par email) quand un site tombe.

Imaginez : vous êtes développeur web ou vous travaillez dans une agence web et vous aimeriez garder un œil, gratuitement, sur les sites que vous avez développés pour vos clients. Ces sites sont-ils en ligne en ce moment, ou sont-ils down ?

C'est le travail des plateformes de monitoring de sites. Pouvez-vous en installer une sur votre machine ? Bien sûr !

Il existe des tonnes d'*outils de monitoring auto-hébergés* ; l'un d'eux est [Uptime Kuma](https://github.com/louislam/uptime-kuma). Vous pouvez jouer avec le site de démonstration ici : <https://demo.kuma.pet/>. Créez simplement un compte admin (gratuitement) et vous êtes prêt à ajouter vos premiers sites.

Comme indiqué dans la [documentation officielle](https://github.com/louislam/uptime-kuma#-docker), vous pouvez le démarrer facilement avec la commande ci-dessous.

```bash
$ `docker run -d --restart=always -p 3001:3001 -v \${PWD}:/app/data --name uptime-kuma louislam/uptime-kuma:1`
```

> Screenshot — http\://localhost:3001
>
> ![Dashboard](./images/dashboard.webp)

> **N'oubliez pas d'ajouter un volume:**
>
> Le flag `-v ${PWD}:/app/data` (un [volume](/blog/docker-volume)) est important si vous voulez conserver les sites que vous ajouterez au dashboard (c'est-à-dire si vous redémarrez l'outil). Si vous voulez juste jouer une fois avec l'interface, vous pouvez l'omettre : rien ne sera écrit sur le disque.

Dans la page des paramètres, site par site, vous pouvez définir de nombreuses actions, comme ce que l'outil de monitoring doit faire quand le site est down. Par exemple, vous envoyer une notification sur *Mattermost*, un email ou ...

![Notification via Mattermost](./images/notification.webp)

> **Il y a tellement de paramètres à configurer:**
>
> En plus des éléments de configuration site par site, vous trouverez aussi dans la page *Profile -> Settings* un grand nombre de paramètres globaux, comme le choix de la langue de l'interface (le français est disponible).

Uptime Kuma surveille vos sites **depuis l'extérieur**. Pour ce qui se passe sur votre propre machine, [Get health information from your running containers](/blog/docker-healthy) fait le même travail pour vos containers. Et une fois que vous auto-hébergez quelques outils de ce genre, [Heimdall](/blog/heimdall-dashboard) est une chouette façon de les rassembler sur une seule page d'accueil.
