# Installation de Beszel

### Prérequis

Pour cette installation, il faut :

- Une machine/serveur disposant de Docker
- Docker Compose d'installé
- Un accès SSH aux serveurs à surveiller
- Un accès administrateur sur les machines concernées
- *Et bien évidemment, un navigateur web pour accéder à l'interface*

<p class="callout info">*Beszel peut être aussi installé autrement (par exemple avec un binaire sur Linux etc.) mais ce guide se concentre sur une installation via Docker Compose*</p>

Ma configuration actuelle pour le projet est un hub Beszel installé sur un Mac Mini M1 via Docker Compose, l'interface utilise le port 8090

### Installation du Hub Beszel

Sur le Mac Mini, j'ai commencé par créer un dossier dédié :

```bash
mkdir -p ~/docker/beszel
cd ~/docker/beszel
```

J'ai ensuite créé dans ce dossier le fichier `docker-compose.yml`

```bash
nano docker-compose.yml
```

Puis j'y ai ajouté la configuration suivante :

```yaml
services:
  beszel:
    image: henrygd/beszel
    container_name: beszel
    restart: unless-stopped
    environment:
      - APP_URL=http://localhost:8090
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data
```

Cette configuration permet de lancer Beszel sur le port `8090`

Le dossier `beszel_data` permet de conserver les données de Beszel même après un redémarrage ou si je recrée le conteneur

<span data-me-change="delta">Là, j’ai mis la variable </span>`<span data-me-change="delta">APP_URL</span>`<span data-me-change="delta"> avec localhost, car je n’utilise pas de domaine pour y accéder, mais si jamais j’utilisais un domaine, j’aurais dû changer cette valeur.</span>

---

<span data-me-change="delta">Une fois la configuration prête, j'ai démarré le conteneur :</span>

```bash
docker compose up -d
```

<span data-me-change="delta">Et j'ai vérifié qu'il était bien lancé :</span>

```bash
docker ps
```

Je peux utiliser aussi l'interface de Portainer pour voir si tout va bien !

[![image.png](https://librenard.fr/wiki/uploads/images/gallery/2026-06/scaled-1680-/S9Uimage.png)](https://librenard.fr/wiki/uploads/images/gallery/2026-06/S9Uimage.png)