Docker-Compose-Stacks mit Dockge verwalten

Veröffentlicht am 7. August 2026 · Geschätzte Lesezeit: 4 Minuten

Dockge ist eine Weboberfläche für Docker-Compose-Projekte. Du kannst compose.yaml-Dateien bearbeiten, Images aktualisieren und komplette Stacks starten oder stoppen, während die Dateien weiterhin normal auf dem Server liegen. Die Einrichtung dauert ungefähr 10 Minuten.

Voraussetzungen

• Ein Linux-Server mit Docker und Docker Compose
• Eine feste private IP-Adresse für den Server
• Port 5001/TCP ist im Heimnetz frei
• SSH-Zugriff und ein Benutzer mit sudo-Rechten

1. Ordner vorbereiten

Dockge speichert seine eigenen Daten unter /opt/dockge. Die verwalteten Compose-Projekte liegen getrennt davon unter /opt/stacks:

sudo mkdir -p /opt/dockge/data /opt/stacks
sudo chown -R "$USER":"$USER" /opt/dockge /opt/stacks
cd /opt/dockge

2. Benutzer-ID ermitteln

Zeige auf dem Server deine numerische Benutzer- und Gruppen-ID an:

id -u
id -g

Merke dir beide Zahlen. Häufig lautet das Ergebnis jeweils 1000, es kann auf deinem System aber abweichen.

3. Compose-Datei anlegen

Erstelle /opt/dockge/compose.yaml. Ersetze <server-ip> durch die private IP des Servers. Ersetze <uid> und <gid> durch die beiden zuvor angezeigten Zahlen.

services:
  dockge:
    image: louislam/dockge:1
    container_name: dockge
    restart: unless-stopped
    ports:
      - "<server-ip>:5001:5001"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      - /opt/stacks:/opt/stacks
    environment:
      DOCKGE_STACKS_DIR: /opt/stacks
      PUID: "<uid>"
      PGID: "<gid>"

Dockge besitzt weitreichende Rechte

Über den Docker-Socket kann Dockge Container und eingebundene Host-Pfade verändern. Leite Port 5001 niemals im Router ins Internet weiter. Nutze die Weboberfläche nur im vertrauenswürdigen Heimnetz oder über ein VPN.

4. Dockge starten

Starte den Container im Ordner /opt/dockge:

docker compose up -d

Prüfe, ob er läuft:

docker compose ps

Öffne anschließend http://<server-ip>:5001 im Browser. Ersetze <server-ip> durch die private Server-IP. Lege beim ersten Aufruf das Administratorkonto mit einem langen, einmaligen Passwort an.

5. Ersten Stack erstellen

Klicke in Dockge auf Compose und vergib als Stack-Namen zum Test hello-world. Füge in den Editor diese harmlose Compose-Datei ein:

services:
  hello:
    image: nginx:alpine
    container_name: dockge-test
    restart: unless-stopped
    ports:
      - "8088:80"

Klicke auf Deploy. Öffne danach http://<server-ip>:8088. Die Seite zeigt die Nginx-Willkommensseite. Beende und lösche den Test-Stack nach der Prüfung wieder über Dockge, wenn du ihn nicht behalten möchtest.

6. Vorhandenen Stack übernehmen

Dockge erwartet jeden Stack in einem eigenen Unterordner unter /opt/stacks. Stoppe einen bestehenden Stack zuerst in seinem bisherigen Ordner. Verschiebe seine vollständige Projektmappe dann nach /opt/stacks/<stack-name> und achte darauf, dass die Compose-Datei compose.yaml heißt.

Prüfe vor dem Verschieben den Zielordner. Ersetze <stack-name> durch einen kurzen Namen in Kleinbuchstaben:

sudo mkdir -p "/opt/stacks/<stack-name>"

Kopiere die vorhandenen Dateien bewusst manuell in diesen Ordner. Verwende keine pauschalen Verschiebebefehle, solange du nicht geprüft hast, welche relativen Pfade und .env-Dateien der Stack benötigt. Wähle danach in Dockge oben rechts Scan Stacks Folder.

Relative Datenpfade mitnehmen

Ein Eintrag wie ./data:/data bezieht sich auf den Ordner der Compose-Datei. Kopiere deshalb auch den zugehörigen data-Ordner oder ändere den Mount auf einen geprüften absoluten Pfad. Erstelle vorher immer ein Backup.

7. Backup und Rückweg

Stoppe nur Dockge. Die von Dockge verwalteten Stacks laufen dabei weiter:

cd /opt/dockge
docker compose stop dockge

Lege den Backup-Ordner an:

sudo mkdir -p /var/backups

Sichere Dockge-Daten und sämtliche Stack-Dateien:

sudo tar -czf "/var/backups/dockge-$(date +%F).tar.gz" -C /opt dockge stacks

Starte Dockge wieder:

cd /opt/dockge
docker compose start dockge

Für den Rückweg stoppst du Dockge, sicherst den aktuellen Stand und entpackst das gewünschte Archiv wieder unter /opt. Die Containerdaten eines Stacks sind nur dann enthalten, wenn sie innerhalb der gesicherten Ordner liegen.

8. Aktualisieren und Fehler finden

Erstelle vor dem Update ein Backup. Aktualisiere Dockge danach mit den offiziell empfohlenen Compose-Befehlen:

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

Zeige bei Problemen die letzten Meldungen an:

docker compose logs --tail=100 dockge

• Stack wird nicht gefunden: Ordnerstruktur /opt/stacks/<stack-name>/compose.yaml und Scan Stacks Folder prüfen.
• Zugriff verweigert: <uid> und <gid> kontrollieren sowie die Rechte von /opt/stacks prüfen.
• Port 5001 belegt: In der linken Zahl der Portzeile einen freien Port wählen und die Browseradresse entsprechend anpassen.
• Stack startet im Terminal, aber nicht in Dockge: Relative Pfade und eine eventuell fehlende .env-Datei kontrollieren.

9. Quellen und Video

• Offizielles Dockge-Projekt mit Installationsanleitung
• Offizieller Compose-Generator
• Video: Besser als Portainer? Dockge auf Deutsch

Fertig

Dockge verwaltet nun Compose-Stacks aus /opt/stacks, ohne deren Dateien in ein eigenes Format umzuwandeln. Prüfe beim Test-Stack, ob Starten, Stoppen und das Anzeigen der Protokolle funktionieren. Lösche anschließend den Test-Stack oder verwende ihn als Vorlage für ein eigenes Projekt.