Dockge im Detail: Stacks über compose.yaml steuern statt Container einzeln zu verwalten

compose.yaml als zentrale Verwaltungseinheit: Dockges dateibasierter Ansatz

Dockge beschreibt sich selbst als einen aufwendigen, leicht bedienbaren und reaktiven Manager für Docker-Compose-Stacks, der konsequent auf die compose.yaml setzt. Die Funktionsliste beginnt mit dem Lebenszyklus dieser Dateien: Erstellen, Bearbeiten, Starten, Stoppen, Neustarten und Löschen, dazu das Aktualisieren von Docker-Images. Neu in Version 1.4.0 ist die Mehr-Agenten-Unterstützung, mit der sich Stacks von verschiedenen Docker-Hosts in einer einzigen Oberfläche verwalten lassen.

Der strukturelle Punkt ist die dateibasierte Ablage. Das README betont, Dockge entführe keine Compose-Dateien: Sie bleiben als gewöhnliche Dateien auf dem eigenen Laufwerk liegen und lassen sich weiterhin mit normalen docker compose-Befehlen bearbeiten. Diese Entscheidung hebt Dockge von Verwaltungsleisten ab, die eigene Datenbanken oder Metadatenspeicher pflegen, und bedeutet im Umkehrschluss, dass außerhalb von Dockge geänderte Dateien nicht widersprüchlich sind. Das Projekt basiert auf Compose V2, wobei compose.yaml und docker-compose.yml synonym gemeint sind; die Hauptsprache im Repository louislam/dockge ist TypeScript.

Installation in /opt/dockge mit Standard-Port 5001

Vorausgesetzt werden Docker 20+ oder Podman, wobei Podman auf Debian das Paket podman-docker erfordert. Unterstützte Systeme sind Ubuntu, Debian und Raspbian ab Bullseye, CentOS, Fedora und ArchLinux; Debian/Raspbian Buster oder älter wird ausgeschlossen, Windows laut README noch nicht unterstützt. Architekturen sind armv7, arm64 und amd64. Die Basisinstallation besteht aus wenigen Befehlen: mkdir -p /opt/stacks /opt/dockge, dann curl der compose.yaml aus dem master-Zweig und schließlich docker compose up -d.

Danach läuft die Oberfläche auf http://localhost:5001. Für abweichende Pfade bietet der Autor einen Generator auf dockge.kuma.pet, der eine compose.yaml mit Query-Strings wie port=5001 und stacksPath=/opt/stacks erzeugt, alternativ lässt sich die Umgebungsvariable DOCKGE_STACKS_DIR setzen. Wichtig ist der Hinweis, dass Pfade im Container identisch zum Host sein müssen, sonst landen Daten am falschen Ort. Für private Registries dokumentiert das README, das Auth-Verzeichnis /root/.docker in den Container zu mounten; die Variablen PUID und PGID steuern die Dateieigentümerschaft der Stacks, standardmäßig root.

Editor, Web-Terminal und der docker-run-Konverter

Neben den Stack-Grundaktionen bringt Dockge drei Werkzeuge mit, die das README als Kern präsentiert. Der interaktive Editor für compose.yaml erlaubt direktes Bearbeiten im Browser; das Web-Terminal hält Zugriff auf die Container-Umgebung, ohne dass SSH nötig wäre. Der Konverter nimmt docker run-Befehle entgegen und wandelt sie in compose.yaml-Form um, was beim Migrieren alter Einzeiler-Setups in dateibasierte Stacks hilft.

Das Wort reaktiv bezieht sich laut README auf Durchgängigkeit des Feedbacks: Fortschritte bei Pull-, Up- und Down-Vorgängen sowie die Terminal-Ausgabe erscheinen in Echtzeit. Die Motivationssektion erklärt, woher das kommt: Der Autor nutzte lange Portainer und stieß dort beim Deployment von Stacks auf Ladeanzeige-Schleifen von Minuten ohne sichtbaren Fortschritt sowie auf unklare Fehlermeldungen. Zusätzlich wollte er die Entwicklung mit ES Modules und TypeScript erproben, was zur Sprachangabe des Repositorys passt. Über die genannten Punkte hinaus dokumentiert das README keine Leistungs- oder Sicherheitsdetails.

Mehrere Docker-Hosts über Agents verbinden

Seit 1.4.0 lassen sich mehrere Agents verbinden, um Stacks von verschiedenen Docker-Hosts in einer Oberfläche zu verwalten. Für einen Heimbetreiber mit mehreren Maschinen, etwa einem Hauptserver und einem Raspberry Pi, bedeutet das, dass beide Hosts aus einem Browserfenster bedient werden können, ohne auf jedem Gerät eine eigene Verwaltungsinstanz zu starten.

Das README bleibt an dieser Stelle knapp: Es beschreibt Registrierung, Authentifizierung oder Netzwerkdetails der Agents nicht näher, ebenso wenig Fehlverhalten bei getrennten Verbindungen. Wer einen Multi-Host-Betrieb plant, sollte daher die Version 1.5.0 vom 30. März 2025 als Ausgangspunkt nehmen und die verlinkten GitHub-Discussions zu Agent-Themen prüfen, bevor Infrastruktur umgestellt wird. Die Release-Historie zeigt zudem große Lücken: Zwischen 1.4.2 im Januar 2024 und 1.5.0 im März 2025 liegt über ein Jahr, was bei der Bewertung der Wartungsdynamik einfließen sollte.

Bestehende Stacks einbinden und der Portainer-Vergleich

Existierende Stacks lassen sich einbinden, allerdings mit einem Pflichtschritt: Die compose-Datei muss ins Stacks-Verzeichnis umziehen, konkret nach /opt/stacks/<stackName>/compose.yaml. Danach genügt in Dockge ein Klick auf Scan Stacks Folder im Dropdown rechts oben, und der Stack erscheint in der Liste. Vor dem Umzug empfiehlt das README, den Stack zu stoppen, um Konflikte zwischen laufenden Containern und der neuen Verwaltung zu vermeiden.

Auf die Frage, ob Dockge ein Portainer-Ersatz sei, antwortet die FAQ mit Ja oder Nein, je nach Szenario. Portainer deckt viele Docker-Funktionen ab; Dockge konzentriert sich auf docker-compose mit einer eigenen Benutzeroberfläche. Wer ausschließlich mit Compose arbeitet, bekommt eine klare Alternative; wer Docker-Netzwerke oder einzelne Container ohne compose.yaml verwalten muss, wird an Portainer oder die Docker-CLI verwiesen, denn Dockges Hauptziel ist es, für alles compose.yaml zu verwenden. Beide Tools gleichzeitig zu installieren ist laut FAQ ausdrücklich möglich.

Namensherkunft von Twitch-Emotes und Lizenz unter MIT

Der Name ist ein Kunstwort des Autors Louis Lam, der ursprünglich eine Klangähnlichkeit zu Dodge anstrebte; dass viele Nutzer Dockage sagen, akzeptiere er. Die Endung -ge stammt von Twitch-Emotes wie sadge, bedge oder wokege. Solche Details stehen bewusst im README und machen die Community-Nähe des Projekts sichtbar: Bug-Meldungen laufen über GitHub Issues, Hilfe über Discussions, Übersetzungen über einen eigenen Leitfaden im Verzeichnis frontend/src/lang.

Beitragende werden auf den CONTRIBUTING-Leitfaden verwiesen, da nicht alle Pull-Request-Arten akzeptiert werden. Das Repository steht unter der MIT-Lizenz, was kommerzielle Nutzung, Modifikation und Weiterverteilung bei Beibehaltung des Copyright-Hinweises erlaubt. Die Metadaten zeigen rund 24.200 Sterne bei 818 Forks, der master-Zweig wurde zuletzt Ende März 2025 aktualisiert. Updates des Tools selbst folgen dem Muster, das auch für Stacks gilt: cd /opt/dockge, dann docker compose pull und docker compose up -d.

Redaktionelles Fazit

Dockge passt für Betreiber, die ihre Docker-Workloads konsequent über Compose definieren und eine reaktive Weboberfläche dafür suchen, inklusive mehrerer Docker-Hosts über Agents. Weniger geeignet ist es, wenn einzelne Container ohne compose.yaml, Netzwerkverwaltung oder Portainers volle Funktionsbreite gebraucht werden. Vor der Installation sollte geprüft werden, ob die eigene Distribution mindestens Debian Bullseye entspricht und ob das Stacks-Verzeichnis /opt/stacks oder ein eigener Pfad über DOCKGE_STACKS_DIR verwendet werden soll.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes