🎯 TUTORIEL PAS À PAS

📊 Installation de Beszel – Monitoring léger de serveurs

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

Beszel est un outil de monitoring léger et élégant qui permet de surveiller l'état de vos serveurs. Il se compose de deux parties : un hub (serveur central) qui collecte les données, et un agent installé sur chaque serveur à surveiller. Ce tutoriel couvre l'installation du hub avec Docker Compose.

📌 Prérequis :

Un serveur avec Docker et Docker Compose installés.
Le port 8090 (ou un autre) disponible.
Un nom de domaine pour l'accès HTTPS (optionnel).

1 Présentation de Beszel

Architecture

Hub : serveur central qui collecte les données des agents et expose une interface web.
Agent : binaire léger installé sur chaque serveur à surveiller.
Les agents se connectent au hub via WebSocket pour envoyer les métriques.

2 Préparation du projet

Étape 1 – Créer le répertoire

$ mkdir -p ~/beszel && cd ~/beszel

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

$ nano docker-compose.yml

---
services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: always
    ports:
      - "8090:8090"
    volumes:
      - ./data:/beszel_data

🔍 Explication :

image: henrygd/beszel:latest : image officielle du hub Beszel.
volumes : persiste les données (configurations, métriques).
ports : expose l'interface web sur le port 8090.

3 Démarrage et configuration

Étape 1 – Lancer le conteneur

$ docker compose up -d

✅ Le conteneur beszel est démarré.

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

http://IP_DU_SERVEUR:8090

✅ La page d'accueil de Beszel s'affiche.

Étape 3 – Créer un compte administrateur

Lors de la première connexion, créez un compte administrateur avec un nom d'utilisateur et un mot de passe sécurisé.

Étape 4 – Ajouter un serveur à surveiller

Dans l'interface, cliquez sur Ajouter un système. Beszel vous fournira un script d'installation pour l'agent à exécuter sur le serveur cible. L'agent se connecte automatiquement au hub via WebSocket.

Exemple de commande d'installation de l'agent :
$ curl -sL https://beszel.dev/install.sh | bash -s -- --key "votre_clé_publique" --host "IP_DU_HUB" --port 8090

4 (Optionnel) HTTPS avec Traefik

Ajouter les labels Traefik

---
services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: always
    volumes:
      - ./data:/beszel_data
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.beszel.rule=Host(`monitor.mon-domaine.fr`)"
      - "traefik.http.routers.beszel.entrypoints=websecure"
      - "traefik.http.routers.beszel.tls.certresolver=le"
      - "traefik.http.services.beszel.loadbalancer.server.port=8090"

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

🎉 Installation réussie si :

L'interface de Beszel est accessible sur http://IP:8090.
Vous pouvez créer un compte administrateur.
Vous pouvez ajouter un serveur via l'interface.
Les métriques s'affichent sur le tableau de bord.

📚 Ressources

← Retour au portail

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