Tutos 14 min de lecture

Configurer Dockge pour gérer ses conteneurs Docker en 2026

Découvrez comment installer et configurer Dockge, un gestionnaire de stacks Docker compose léger et auto-hébergé, idéal pour les homelabs et l'auto-hébergement.

S Par Selfhostr · sans contenu sponsorisé
Configurer Dockge pour gérer ses conteneurs Docker en 2026
Cet article peut contenir des liens affiliés (sans surcoût pour toi, ça finance le site). En tant que Partenaire Amazon, Selfhostr réalise un bénéfice sur les achats remplissant les conditions requises. Voir la disclosure.

👍 On aime

  • Interface web légère et réactive, optimisée pour les stacks Docker compose
  • Éditeur interactif intégré pour modifier les fichiers compose.yaml directement dans le navigateur
  • Prise en charge des logs et terminaux interactifs en temps réel
  • Structure basée sur des fichiers, compatible avec les commandes Docker standard

👎 On regrette

  • Ne gère que les stacks Docker compose, pas les conteneurs lancés via docker run seul
  • L'interface peut être moins intuitive pour les débutants en comparaison avec des solutions plus complètes comme Portainer
  • Accès au socket Docker : à ne jamais exposer directement sur Internet
📑 Sommaire ▾

Dockge est un gestionnaire de stacks Docker compose auto-hébergé, conçu pour simplifier la gestion des conteneurs dans un environnement homelab. Contrairement à des solutions plus lourdes qui stockent les configurations dans une base de données interne, Dockge utilise des fichiers compose.yaml placés sur le disque, ce qui garantit leur portabilité et leur compatibilité avec les commandes Docker standard. L’outil permet d’éditer, de déployer et de surveiller les stacks directement depuis une interface web, sans avoir à manipuler manuellement les fichiers ou à utiliser plusieurs terminaux. Dockge est particulièrement adapté aux utilisateurs qui gèrent un petit nombre de stacks sur un ou deux hôtes Docker, offrant une solution légère et efficace pour centraliser ces opérations. L’installation de Dockge ne nécessite qu’un seul conteneur, ce qui réduit son empreinte sur le système et le rend idéal pour les homelabs.

Prérequis

Pour installer et configurer Dockge, vous aurez besoin des éléments suivants :

  • Un hôte Linux avec Docker Engine installé (Ubuntu 26.04 ou 24.04, Debian Bullseye ou plus récent, ou une autre distribution majeure supportée par Docker)
  • Un utilisateur avec des droits sudo sur cet hôte
  • Le port TCP 5001 libre pour l’interface web de Dockge
  • Un répertoire dédié pour stocker vos stacks Docker compose (par défaut /opt/stacks, mais peut être personnalisé)
  • Docker Compose v2 ou Podman (si vous utilisez Podman, installez podman-docker pour la compatibilité avec Docker)
  • Un navigateur web pour accéder à l’interface de Dockge

Installation pas à pas

Étape 1 : Préparer l’environnement système

Avant d’installer Dockge, assurez-vous que votre système est prêt à exécuter Docker. Dockge nécessite Docker Engine pour fonctionner, et il est recommandé d’utiliser Docker Compose v2 pour une meilleure intégration. Si vous utilisez Podman, installez le paquet podman-docker pour une compatibilité avec Docker.

Pour les utilisateurs de Docker, vérifiez que Docker est bien installé et fonctionnel. Dockge s’exécute comme un conteneur, donc la présence de Docker est suffisante pour commencer. Si vous utilisez un VPS ou un NAS, assurez-vous que Docker est disponible et que vous avez un utilisateur avec des droits sudo pour gérer les stacks.

Pour vérifier que Docker est bien installé, exécutez la commande suivante :

sudo docker --version

Cette commande doit afficher une version de Docker. Vérifiez aussi que le plugin Compose v2 est présent avec docker compose version.

Si Docker n’est pas installé, le script officiel de Docker installe Docker Engine et le plugin Compose depuis le dépôt de Docker (c’est aussi la méthode indiquée par le README de Dockge) :

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Relancez ensuite sudo docker --version et sudo docker compose version : les deux commandes doivent répondre sans erreur.

Étape 2 : Configurer le répertoire des stacks

Dockge utilise un répertoire dédié pour stocker les fichiers compose.yaml de vos stacks. Par défaut, ce répertoire est /opt/stacks, mais vous pouvez le personnaliser si nécessaire. Pour éviter les problèmes de permissions, il est recommandé de créer ce répertoire avec un utilisateur non-root.

Créez le répertoire des stacks et définissez les permissions appropriées :

sudo mkdir -p /opt/stacks
sudo chown -R $USER:$USER /opt/stacks

Ces commandes créent le répertoire /opt/stacks s’il n’existe pas déjà, et définissent les permissions pour que l’utilisateur actuel puisse y accéder. Si vous utilisez un autre utilisateur, remplacez $USER par le nom de cet utilisateur.

Pour vérifier que le répertoire est bien créé et accessible, exécutez :

ls -ld /opt/stacks

Cette commande doit afficher des informations sur le répertoire, par exemple drwxr-xr-x 2 user user 4096 Oct 16 10:00 /opt/stacks. Si le répertoire n’est pas accessible, vérifiez les permissions avec chmod ou chown selon vos besoins.

Étape 3 : Installer Dockge via Docker Compose

Dockge est conçu pour être installé via Docker Compose, ce qui simplifie le déploiement et la gestion de l’application. Vous pouvez utiliser le fichier compose.yaml par défaut ou le personnaliser selon vos besoins. Pour une installation de base, utilisez le fichier par défaut et déployez Dockge dans le répertoire /opt/dockge.

Créez le dossier de Dockge, puis téléchargez le fichier compose.yaml officiel :

sudo mkdir -p /opt/dockge
sudo chown $USER:$USER /opt/dockge
cd /opt/dockge
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

Ces commandes placent le fichier compose.yaml dans le répertoire /opt/dockge. Vous pouvez ensuite le personnaliser si nécessaire, par exemple pour changer le port ou le répertoire des stacks.

Déployez Dockge avec Docker Compose :

sudo docker compose up -d

Cette commande démarre Dockge en arrière-plan. Dockge utilise le socket Docker pour interagir avec votre hôte Docker, donc il est essentiel que le socket soit correctement monté dans le conteneur. Par défaut, le fichier compose.yaml configure le socket Docker et le répertoire des stacks comme suit :

services:
  dockge:
    image: louislam/dockge:1
    restart: unless-stopped
    ports:
      - 5001:5001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      - /opt/stacks:/opt/stacks
    environment:
      - DOCKGE_STACKS_DIR=/opt/stacks

À la première ouverture, Dockge demande de créer le compte administrateur : faites-le tout de suite, la première personne qui ouvre la page devient administrateur.

Pour vérifier que Dockge est bien installé et en cours d’exécution, accédez à l’interface web via l’adresse suivante :

http://adresse-du-serveur:5001 (ou http://localhost:5001 depuis la machine elle-même).

Si l’interface web s’affiche, l’installation a réussi. Vous pouvez également vérifier l’état du conteneur avec :

sudo docker compose ps

Cette commande doit afficher dockge comme étant en cours d’exécution.

Étape 4 : Personnaliser le fichier compose.yaml

Pour utiliser un autre répertoire de stacks ou un autre port, modifiez le fichier compose.yaml. Pour le répertoire, trois valeurs doivent être identiques : les deux côtés du volume et la variable DOCKGE_STACKS_DIR, toujours en chemin absolu. Exemple avec /srv/stacks :

services:
  dockge:
    image: louislam/dockge:1
    restart: unless-stopped
    ports:
      - 5001:5001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      - /srv/stacks:/srv/stacks
    environment:
      - DOCKGE_STACKS_DIR=/srv/stacks

Si les deux côtés du volume diffèrent, les commandes Docker lancées par Dockge cherchent les fichiers au mauvais endroit et vos stacks ne démarrent pas correctement. Créez le nouveau répertoire avant de redéployer.

Pour changer le port de l’interface web, modifiez la section ports du service dockge :

services:
  dockge:
    image: louislam/dockge:1
    restart: unless-stopped
    ports:
      - 8080:5001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      - /opt/stacks:/opt/stacks
    environment:
      - DOCKGE_STACKS_DIR=/opt/stacks

Dans cet exemple, le port 8080 du système hôte est mappé au port 5001 du conteneur. Vous pouvez accéder à l’interface web via http://localhost:8080. Après avoir personnalisé le fichier compose.yaml, redéployez Dockge pour appliquer les changements :

sudo docker compose down && sudo docker compose up -d

Pour vérifier que les changements ont été appliqués, accédez à l’interface web via le nouveau port et vérifiez que vos stacks sont bien listés.

Étape 5 : Configurer l’accès sécurisé à Dockge

Par défaut, Dockge n’est accessible qu’en HTTP sur le port 5001. Pour y accéder depuis un autre réseau, le plus sûr reste un VPN (WireGuard, Tailscale). Si vous préférez un nom de domaine en HTTPS, placez un reverse proxy comme Nginx devant.

Pour configurer Nginx comme reverse proxy, créez un fichier de configuration pour votre domaine ou sous-domaine pointant vers le port 5001 de l’hôte local. Voici un exemple de configuration Nginx pour Dockge :

server {
    listen 80;
    server_name dockge.votredomaine.com;

    location / {
        proxy_pass http://127.0.0.1:5001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Les trois lignes proxy_http_version, Upgrade et Connection sont indispensables : l’interface de Dockge passe par des WebSockets pour les journaux et les terminaux en direct.

Remplacez dockge.votredomaine.com par le nom de domaine ou sous-domaine que vous souhaitez utiliser pour accéder à Dockge. Si vous utilisez un NAS ou un VPS, assurez-vous que le nom de domaine est correctement configuré et pointe vers l’adresse IP de votre hôte.

Pour activer HTTPS, utilisez un certificat SSL. Vous pouvez obtenir un certificat SSL gratuit via Let’s Encrypt en configurant Certbot pour gérer les certificats automatiquement. Voici les commandes pour installer Certbot et obtenir un certificat SSL :

sudo apt-get install -y certbot python3-certbot-nginx
sudo certbot --nginx -d dockge.votredomaine.com

Avec l’option --nginx, Certbot obtient le certificat Let’s Encrypt et modifie lui-même le bloc server : il ajoute l’écoute en 443 avec les chemins du certificat et la redirection depuis le port 80. Vérifiez le résultat avec sudo nginx -t, puis rechargez avec sudo systemctl reload nginx. Le renouvellement automatique se contrôle avec sudo certbot renew --dry-run.

Pour vérifier que l’accès HTTPS est bien configuré, accédez à l’interface web via l’URL https://dockge.votredomaine.com et assurez-vous que le navigateur affiche un cadenas vert, indiquant une connexion sécurisée.

Étape 6 : Déployer une stack Docker via Dockge

Une fois Dockge installé et accessible, vous pouvez déployer une stack Docker via l’interface web. Dockge permet de créer, éditer et déployer des stacks Docker directement depuis le navigateur, ce qui simplifie grandement le processus.

Pour déployer une stack, suivez ces étapes :

  1. Accédez à l’interface web de Dockge via votre navigateur.
  2. Cliquez sur le bouton “Nouvelle stack” pour créer un nouveau fichier compose.yaml.
  3. Donnez un nom à votre stack : Dockge la range automatiquement dans un sous-dossier du répertoire des stacks (/opt/stacks/nom-de-la-stack).
  4. Éditez le contenu du fichier compose.yaml directement dans l’interface web. Vous pouvez utiliser l’éditeur interactif pour modifier les fichiers sans avoir à les manipuler manuellement depuis le terminal.
  5. Cliquez sur “Déployer” pour appliquer les changements et démarrer les conteneurs définis dans votre stack.

Voici un exemple de stack Docker que vous pouvez déployer via Dockge. Cet exemple utilise un conteneur Nginx simple :

services:
  web:
    image: nginx:latest
    restart: unless-stopped
    ports:
      - 8080:80
    volumes:
      - ./html:/usr/share/nginx/html

Pour vérifier que la stack a été correctement déployée, accédez à l’interface web de Dockge et vérifiez que la stack apparaît dans la liste des stacks. Vous pouvez également vérifier que le conteneur est en cours d’exécution avec :

cd /opt/stacks/nom-de-la-stack
sudo docker compose ps

Dockge range chaque stack dans son propre dossier (/opt/stacks/nom-de-la-stack/compose.yaml). Remplacez nom-de-la-stack par le nom donné à l’étape précédente : la commande doit afficher le conteneur web en cours d’exécution.

Étape 7 : Mettre à jour Dockge

Dockge est régulièrement mis à jour pour ajouter de nouvelles fonctionnalités et corriger des bugs. Pour mettre à jour Dockge, utilisez Docker Compose pour tirer la dernière version de l’image et redéployer le conteneur.

Pour mettre à jour Dockge, exécutez les commandes suivantes :

cd /opt/dockge
sudo docker compose pull && sudo docker compose up -d

Ces commandes téléchargent la dernière version de l’image Dockge et redéploient le conteneur avec les nouveaux paramètres. Pour vérifier que la mise à jour a réussi, accédez à l’interface web et vérifiez la version affichée en bas de page.

Étape 8 : Sauvegarder vos stacks

Dockge stocke vos stacks sous forme de fichiers compose.yaml dans le répertoire /opt/stacks. Il est essentiel de sauvegarder régulièrement ces fichiers pour éviter toute perte de données en cas de problème sur votre hôte Docker.

Pour sauvegarder vos stacks, copiez le répertoire /opt/stacks vers un autre emplacement ou un système de stockage externe. Voici un exemple de commande pour copier le répertoire vers un emplacement de sauvegarde :

sudo mkdir -p /opt/backup
sudo cp -r /opt/stacks /opt/backup/dockge-stacks-$(date +%Y-%m-%d)

Cette commande copie le répertoire /opt/stacks vers un emplacement de sauvegarde avec un nom basé sur la date du jour. Vous pouvez également utiliser un outil de sauvegarde comme rsync pour synchroniser le répertoire vers un autre emplacement :

sudo rsync -avz /opt/stacks/ /opt/backup/dockge-stacks-$(date +%Y-%m-%d)/

Pour vérifier que la sauvegarde a réussi, listez le contenu du répertoire de sauvegarde :

ls /opt/backup/dockge-stacks-$(date +%Y-%m-%d)

Cette commande doit afficher un dossier par stack. Sauvegardez aussi /opt/dockge/data, qui contient le compte administrateur et les réglages de Dockge.

Vérifications

Pour confirmer que Dockge est correctement installé et configuré, vérifiez d’abord l’état du conteneur avec la commande suivante :

cd /opt/dockge && sudo docker compose ps

Cette commande doit afficher dockge comme étant en cours d’exécution. Ensuite, accédez à l’interface web via l’adresse http://localhost:5001 (ou le port personnalisé si vous avez modifié la configuration).

Pour les stacks déployées, vérifiez leur état avec :

cd /opt/stacks/nom-de-la-stack && sudo docker compose ps

Remplacez nom-de-la-stack par le nom de votre stack. Cette commande doit afficher les conteneurs de la stack comme étant en cours d’exécution. Si tout est correct, vous devriez voir une interface web fonctionnelle avec vos stacks listées et accessibles.

Sécurité et bonnes pratiques

Dockge monte le socket Docker : qui contrôle Dockge contrôle tous les conteneurs de la machine, ce qui revient à des droits root. N’exposez donc pas le port 5001 sur Internet : passez par un VPN, ou par un reverse proxy en HTTPS limité à vos adresses. Dockge n’a qu’un seul compte, l’administrateur créé à la première ouverture : donnez-lui un mot de passe long et unique.

Mettez régulièrement à jour Dockge pour bénéficier des dernières corrections de sécurité et des nouvelles fonctionnalités. Utilisez Docker Compose pour redéployer le conteneur après une mise à jour :

cd /opt/dockge && sudo docker compose pull && sudo docker compose up -d

Sauvegardez régulièrement vos stacks Docker pour éviter toute perte de données. Utilisez un outil de sauvegarde comme rsync pour synchroniser le répertoire des stacks vers un autre emplacement ou un NAS externe. Dockge stocke les stacks sous forme de fichiers, donc une sauvegarde manuelle ou automatisée de ces fichiers est suffisante pour restaurer vos stacks en cas de problème.

Dépannage : erreurs courantes

Si l’interface web de Dockge ne s’affiche pas après l’installation, vérifiez d’abord que le conteneur est bien en cours d’exécution avec la commande suivante :

cd /opt/dockge && sudo docker compose ps

Si le conteneur n’est pas en cours d’exécution, consultez les logs pour identifier la cause du problème :

sudo docker compose logs

symptôme : l’interface web ne répond pas -> cause : le conteneur n’est pas démarré -> correctif : redéployez le conteneur avec sudo docker compose up -d et vérifiez les logs.

symptôme : impossible de modifier ou déployer une stack -> cause : permissions insuffisantes sur le répertoire des stacks -> correctif : vérifiez que l’utilisateur a les droits nécessaires avec ls -ld /opt/stacks et ajustez les permissions si nécessaire.

symptôme : les conteneurs de la stack ne démarrent pas -> cause : erreur dans le fichier compose.yaml -> correctif : vérifiez la syntaxe avec cd /opt/stacks/nom-de-la-stack && sudo docker compose config et corrigez les erreurs signalées.

symptôme : les stacks n’apparaissent plus dans Dockge -> cause : répertoire des stacks mal configuré -> correctif : vérifiez avec cat /opt/dockge/compose.yaml que les deux côtés du volume et DOCKGE_STACKS_DIR désignent le même chemin absolu.

symptôme : l’interface s’affiche mais les journaux et le terminal restent vides derrière le reverse proxy -> cause : WebSockets non transmis -> correctif : ajoutez les lignes proxy_http_version 1.1, Upgrade et Connection de l’étape 5.

FAQ

Comment accéder à Dockge depuis un autre hôte Docker ?

Installez Dockge sur chaque hôte, puis ajoutez les autres instances comme « agents » depuis l’interface du Dockge principal (adresse, identifiant et mot de passe de l’autre instance). N’exposez jamais le socket Docker d’un hôte sur le réseau : quiconque y accède obtient des droits root sur la machine.

Dockge est-il compatible avec toutes les distributions Linux ?

Dockge est compatible avec les distributions Linux majeures qui peuvent exécuter Docker, comme Ubuntu, Debian Bullseye ou plus récent, Fedora, ArchLinux, ou CentOS. Debian Buster, Raspbian Buster et les versions plus anciennes ne sont pas prises en charge par Dockge : mettez d’abord le système à jour.

Peut-on utiliser Dockge avec Podman ?

Oui, Dockge peut être utilisé avec Podman. Pour cela, installez podman-docker sur votre système, puis utilisez Docker Compose pour déployer Dockge. Les commandes et la configuration restent les mêmes, mais Dockge interagira avec Podman au lieu de Docker Engine.

Comment restaurer une stack Docker depuis une sauvegarde ?

Pour restaurer une stack Docker depuis une sauvegarde, copiez le dossier de la stack (avec son fichier compose.yaml) vers /opt/stacks/nom-de-la-stack/, puis redéployez la stack avec Docker Compose. Assurez-vous que les permissions du fichier et du répertoire sont correctes pour éviter les problèmes d’accès.

Quelle machine pour l’héberger ?

🖥️ Le matériel pour l’héberger chez vous — Pour faire tourner ce service 24 h/24 sans faire exploser la facture d’électricité, un mini-PC basse consommation suffit dans la plupart des cas. Deux modèles courants : le Beelink Mini S12 Pro (Intel N100, 16 Go) et le Beelink EQ14 (Intel N150, deux ports 2,5 GbE). Pour choisir selon vos besoins : notre comparatif des meilleurs mini-PC pour homelab.

A lire aussi

Héberger ce service

Pas envie de gérer le matériel ni la maintenance ? Ce type de service s’auto-héberge aussi sur un VPS managé, prêt en quelques minutes. Voir les offres PlanetHoster

Chiffres-clés

~45 min
Durée
Intermédiaire
Difficulté
Gratuit (logiciel libre)
Coût
Docker installé et un utilisateur sudo
Prérequis clé
Tags : dockerhomelabauto-hebergementcomposedockge

Sur le même sujet

Tutos

Installer Frigate NVR sur Raspberry Pi 5 en 2026 : le guide complet

Installer Frigate NVR sur Raspberry Pi 5 : Raspberry Pi OS 64 bits, Docker depuis le dépôt officiel, image officielle, config.yml d'une caméra RTSP, port 8971 sécurisé et stockage sur SSD.

Lire
Tutos

Créer un NAS Raspberry Pi 5 en 2026 : Guide Complet

Guide 2026 pour transformer un Raspberry Pi 5 en NAS performant. Boîtier NVMe, Docker, Samba et sécurité pas à pas pour un self-hosting fiable.

Lire
Tutos

Installer Home Assistant Docker en 2026: Guide Pas à Pas

Installez Home Assistant Container avec Docker Compose sur un Linux 64 bits : image officielle, broker Mosquitto sécurisé, Zigbee2MQTT avec votre dongle USB, prise TP-Link HS100 et HTTPS local optionnel avec Caddy.

Lire