Homarr ou Glance : tableau de bord self-hosted pour VPS

Pourquoi un tableau de bord self-hosted sur votre VPS

Cas d'usage concrets

• Page d'accueil de votre navigateur pointant vers votre propre VPS : tous vos services accessibles en un clic.
• Vue d'état en temps réel de vos conteneurs Docker sans ouvrir Portainer ou Dozzle.
• Agrégation de flux RSS et d'actualités tech (Hacker News, Reddit, GitHub releases) sur le même écran que vos services.
• Centralisation des accès pour une équipe ou une agence qui partage un VPS commun.
• Page de démarrage de votre homelab ou de votre infrastructure de développement.
• Supervision légère sans déployer une pile Grafana/Prometheus complète.

Homarr : tableau de bord complet avec interface graphique

Déployer Homarr avec Docker Compose

1. 01

   Créer le répertoire et le fichier Compose

   Sur votre VPS, créez un répertoire dédié et un fichier docker-compose.yml :

   mkdir -p /opt/homarr && cd /opt/homarr

   Contenu du fichier docker-compose.yml :

   services:
     homarr:
       image: ghcr.io/homarr-labs/homarr:latest
       container_name: homarr
       restart: unless-stopped
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
         - ./appdata:/appdata
       environment:
         - SECRET_ENCRYPTION_KEY=votre-cle-aleatoire-32-chars
       ports:
         - "7575:7575"

   SECRET_ENCRYPTION_KEY est obligatoire : Homarr chiffre les secrets de ses intégrations (tokens API, mots de passe) avec cette clé. Générez-en une avec openssl rand -hex 32.

2. 02

   Générer la clé de chiffrement

   Homarr exige une clé de 64 caractères hexadécimaux :

   openssl rand -hex 32

   Copiez la valeur dans SECRET_ENCRYPTION_KEY du fichier Compose. Sans cette variable, le conteneur refuse de démarrer.

3. 03

   Démarrer le conteneur

   docker compose up -d

   Homarr est accessible sur http://votre-domaine.com:7575. Lors du premier accès, créez votre compte administrateur. La configuration initiale (tuiles, thème, intégrations) se fait entièrement depuis l'interface web.

4. 04

   Configurer l'intégration Docker

   Le socket Docker (/var/run/docker.sock) est monté en lecture seule. Dans l'interface Homarr, allez dans Paramètres → Intégrations et ajoutez une intégration Docker pointant vers unix:///var/run/docker.sock. Homarr affichera automatiquement l'état (running/stopped) de vos conteneurs sur les tuiles associées.

5. 05

   Configurer Traefik comme reverse proxy

   Pour exposer Homarr en HTTPS, ajoutez ces labels à votre service dans le fichier Compose :

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.homarr.rule=Host(`dashboard.votre-domaine.com`)"
     - "traefik.http.routers.homarr.entrypoints=websecure"
     - "traefik.http.routers.homarr.tls.certresolver=letsencrypt"
     - "traefik.http.services.homarr.loadbalancer.server.port=7575"

   Supprimez le bloc ports si vous exposez uniquement via Traefik. Consultez l'article Déployer avec Traefik pour la configuration complète.

6. 06

   Alternative nginx

   Si vous utilisez nginx, créez un vhost /etc/nginx/sites-available/homarr.conf :

   server {
       listen 443 ssl;
       server_name dashboard.votre-domaine.com;
   
       ssl_certificate     /etc/letsencrypt/live/dashboard.votre-domaine.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/dashboard.votre-domaine.com/privkey.pem;
   
       location / {
           proxy_pass http://127.0.0.1:7575;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }

   Certificat Let's Encrypt via certbot --nginx -d dashboard.votre-domaine.com.

Glance : un binaire Go, une config YAML, zéro base de données

Déployer Glance avec Docker

1. 07

   Créer le répertoire et le fichier de configuration

   mkdir -p /opt/glance && cd /opt/glance

   Créez un fichier glance.yml minimal avec un widget Hacker News et un widget Docker :

   server:
     host: 0.0.0.0
     port: 8080
   
   pages:
     - name: Accueil
       columns:
         - size: full
           widgets:
             - type: hacker-news
               title: Hacker News
   
         - size: small
           widgets:
             - type: docker-containers
               title: Conteneurs
               collapsed-by-default: false

   Glance expose le port 8080 par défaut.

2. 08

   Lancer avec Docker Compose

   Créez un fichier docker-compose.yml :

   services:
     glance:
       image: glanceapp/glance:latest
       container_name: glance
       restart: unless-stopped
       volumes:
         - ./glance.yml:/app/glance.yml:ro
         - /var/run/docker.sock:/var/run/docker.sock:ro
       ports:
         - "8080:8080"

   Démarrez avec :

   docker compose up -d

   Glance est accessible sur http://votre-domaine.com:8080.

3. 09

   Ajouter un widget météo

   Le widget weather est l'un des plus simples à configurer — il ne demande qu'une localisation :

   - type: weather
     title: Météo
     location: Paris, France
     units: metric
     hour-format: 24h

   Ajoutez ce bloc dans la section widgets de la colonne de votre choix.

4. 10

   Configurer le reverse proxy pour Glance

   Avec Traefik, ajoutez dans votre docker-compose.yml :

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.glance.rule=Host(`glance.votre-domaine.com`)"
     - "traefik.http.routers.glance.entrypoints=websecure"
     - "traefik.http.routers.glance.tls.certresolver=letsencrypt"
     - "traefik.http.services.glance.loadbalancer.server.port=8080"

   Avec nginx, même structure que Homarr, en remplaçant le port par 8080.

5. 11

   Rechargement à chaud de la configuration

   Glance surveille son fichier de configuration et se recharge automatiquement quand vous le modifiez. Pas besoin de redémarrer le conteneur après chaque ajout de widget — docker logs glance -f affichera la ligne Config reloaded après quelques secondes.

Homarr vs Glance : tableau comparatif

Faites défiler le tableau

Exposer en HTTPS avec un reverse proxy

Dépannage : erreurs courantes

Quel outil choisir ?