Pourquoi un gestionnaire visuel pour Docker Compose
Dès que vous faites tourner plus d’une poignée de stacks Docker Compose, le rituel qui consiste à se connecter en SSH à chaque serveur, à naviguer jusqu’au bon répertoire et à lancer docker compose up -d ou docker compose logs devient vite fastidieux. Dockge centralise tout cela dans un seul onglet de navigateur : vous voyez chaque stack, son statut en direct et ses logs d’un coup d’œil. Créer une nouvelle stack, c’est remplir un formulaire — vous collez votre compose.yaml et vous cliquez sur Start. Pas de gestionnaire de fichiers, pas de SSH.
Ce que Dockge auto-hébergé vous apporte
- Éditeur visuel pour les fichiers
compose.yaml— créez ou modifiez vos stacks directement dans le navigateur, avec coloration syntaxique. - Démarrage, arrêt, redémarrage et mise à jour en un clic pour chaque stack — sans SSH ni commandes compose à mémoriser.
- Diffusion des logs en direct par stack et par conteneur, avec une sortie colorisée.
- Tableau de bord en temps réel indiquant quelles stacks sont en cours d’exécution, arrêtées ou en erreur.
- Support multi-instance (v1.4+) : pilotez des instances Dockge sur des hôtes Docker distants depuis une interface principale unique.
- S’exécute dans un seul conteneur, sous 150 Mo de RAM — à ajouter sans risque sur n’importe quel VPS existant, sans impacter les charges de travail en cours.
Prérequis
Un VPS sous Ubuntu 22.04 (ou Debian 12) avec Docker + Docker Compose v2 déjà installés. Dockge lui-même nécessite moins de 150 Mo de RAM et quelques Mo de disque pour sa base de données SQLite. Aucun nom de domaine n’est requis — Dockge sert son interface sur le port 5001 en HTTP simple, accessible via l’IP de votre serveur. Si vous voulez du HTTPS, placez un reverse proxy Caddy ou Nginx devant et émettez un certificat Let’s Encrypt.
Déployer Dockge avec Docker Compose
Créer le répertoire des stacks
Dockge stocke chaque stack qu’il gère sous forme de fichier compose.yaml dans un répertoire dédié de l’hôte — /opt/stacks par défaut. Créez-le avant de démarrer le conteneur : mkdir -p /opt/stacks. Dockge monte ce répertoire dans le conteneur pour que les fichiers survivent aux redémarrages et aux mises à jour du conteneur.
Rédiger le fichier Compose
Créez /opt/dockge/compose.yaml avec le contenu suivant. Le conteneur monte le socket Docker (/var/run/docker.sock) afin de pouvoir gérer les autres conteneurs du même hôte, le répertoire /opt/stacks pour lire et écrire les fichiers de stack, et un volume nommé pour sa propre base de données SQLite. Réglez DOCKGE_STACKS_DIR sur le chemin d’hôte que vous avez choisi.
Démarrer Dockge
Lancez docker compose up -d dans /opt/dockge. L’image (louislam/dockge:1) pèse environ 200 Mo au premier téléchargement. Une fois lancée, ouvrez http://<ip-de-votre-serveur>:5001 dans votre navigateur. Dockge vous invite à créer un compte administrateur lors de la première visite — définissez immédiatement un mot de passe fort.
Ajouter votre première stack
Cliquez sur « + Compose » dans l’interface de Dockge, donnez un nom à la stack (il devient le sous-répertoire sous /opt/stacks), collez le contenu de votre compose.yaml et cliquez sur Start. En coulisses, Dockge exécute docker compose up -d et vous montre en direct les logs de téléchargement et de démarrage. La stack apparaît dans le tableau de bord avec un statut vert une fois que tous les services sont sains.
Optionnel : restreindre l’accès avec un reverse proxy
Par défaut, Dockge écoute sur toutes les interfaces sur le port 5001. Pour éviter de l’exposer à Internet, soit vous le liez à 127.0.0.1:5001 dans le fichier Compose (ajoutez "127.0.0.1:5001:5001" à ports) et vous le placez derrière Caddy ou Nginx, soit vous ajoutez une règle ufw n’autorisant le port 5001 que depuis votre IP : ufw allow from <votre-ip> to any port 5001. N’exposez jamais l’interface de Dockge à Internet sans authentification.
Se connecter la première fois
Ouvrez l'URL : Dockge affiche un écran de création du compte administrateur (aucun identifiant par défaut). Créez-le tout de suite avec un mot de passe fort.
La console web est désactivée par défaut — laissez-la ainsi
Dockge v1.5.0 a désactivé par défaut la console terminal intégrée (accès shell web) à la suite d’un avis de sécurité (GHSA-7vx4-hf96-mqq6). Ne l’activez pas sur une instance exposée publiquement à moins de bien en mesurer le risque. Le reste de Dockge — gestion des stacks, logs, statut — reste pleinement fonctionnel sans la console. Si vous avez besoin d’un accès shell, utilisez une vraie session SSH ou un outil terminal dédié.
