🔄 Anleitung: Dockhand auf Synology installieren, Container verwalten und mehrere NAS-Systeme in einem Dashboard bündeln

Wenn du viele Docker-Container auf deiner Synology oder auf mehreren NAS-Systemen betreibst, wird die Verwaltung schnell unübersichtlich. Genau hier setzt Dockhand an. In dieser Anleitung lernst du, wie du Dockhand auf einer Synology installierst, welche Einstellungen du direkt anpassen solltest und wie du deine Container deutlich komfortabler verwaltest. Außerdem siehst du, wie du alte beziehungsweise untracked Stacks wieder editierbar machst und sogar zwei Systeme in einer einzigen Konsole zusammenführst. Das spart Zeit, reduziert Fehler und gibt dir eine deutlich bessere Übersicht über Updates, Logs, Sicherheit und Status deiner Container. 🚀

Warum Dockhand gerade bei vielen Containern so hilfreich ist

Sobald du regelmäßig mit Docker arbeitest, wächst die Zahl deiner Container oft schneller als gedacht. Viele Verbindungen, Dienste und kleine Tools laufen irgendwann parallel. Dann reicht der klassische Container Manager zwar oft noch aus, aber die tägliche Arbeit wird mühsamer. Genau an diesem Punkt wird Dockhand interessant.

Mit Dockhand kannst du Container, Stacks, Logs, Updates und Sicherheitsscans an einer zentralen Stelle überwachen. Besonders praktisch wird das, wenn du nicht nur ein System nutzt, sondern zum Beispiel eine Synology und zusätzlich noch ein weiteres NAS wie eine UGREEN betreibst.

Dockhand auf der Synology vorbereiten

Bevor du Dockhand installierst, legst du zuerst das passende Verzeichnis an. Dazu gehst du in dein Docker-Verzeichnis und erstellst dort einen Ordner mit dem Namen Dockhand. Dieser Ordner dient später als Ablage für die Konfiguration und die Daten des Containers.

Danach öffnest du im Container Manager ein neues Projekt. Das Projekt nennst du ebenfalls Dockhand. Als Pfad wählst du genau das Verzeichnis aus, das du vorher angelegt hast. Weil das Verzeichnis noch leer ist, erstellst du jetzt direkt eine neue Docker-Compose-Datei.

Hier ist die optimierte Docker-Compose-Datei (passt für Synology und Ugreen:

services:
 dockhand:
   image: fnsys/dockhand:latest
   container_name: dockhand
   ports:
     - "3876:3000"
   volumes:
     - /volume1/docker/dockhand:/app/data
     - /volume1/docker:/volume1/docker
     - /var/run/docker.sock:/var/run/docker.sock
   restart: always

Die Docker-Compose-Datei kannst du von dieser angepassten Vorlage einfügen. Dabei sind zwei Punkte besonders wichtig.

• Port anpassen

Im Beispiel wird nicht der oft verwendete Port 3000 genutzt, sondern 3876. Das ist sinnvoll, weil Port 3000 häufig schon von anderen Containern belegt ist. Du solltest also am besten einen freien Port wählen, damit es später keine Konflikte gibt.

• Volume-Pfad richtig setzen

Ebenso wichtig ist der Pfad für das Datenverzeichnis. Dieser muss exakt zu deinem System passen. Wenn Docker auf volume1 liegt, muss auch dieser Pfad korrekt in die YAML-Datei eingetragen werden. Am einfachsten prüfst du den genauen Speicherort in der File Station über die Eigenschaften des Dockhand-Ordners und übernimmst den Pfad direkt.

Projekt erstellen und Dockhand starten

Wenn die Docker-Compose-Datei angepasst ist, kannst du das Projekt fertigstellen. Danach lädt die Synology das Image herunter, erstellt das Standard-Netzwerk und startet den Container. Nach kurzer Zeit sollte der Status zeigen, dass das Projekt läuft.

Anschließend öffnest du im Browser die IP-Adresse deiner Synology mit dem gewählten Port, also zum Beispiel:

http://ip-der-synology:3876

Wenn sich die Dockhand-Oberfläche öffnet, bist du am Ziel. Dort kannst du direkt auf das dunkle Design umschalten, damit die Oberfläche angenehmer für die Augen wird. 🌙

Erstes Environment einrichten

Direkt nach dem ersten Start fehlt noch die eigentliche Verbindung zur lokalen Docker-Umgebung. Deshalb legst du nun ein neues Environment an.

Als Namen kannst du zum Beispiel Synology wählen. Als Verbindungstyp reicht in diesem Fall die lokale Unix-Verbindung. Danach trägst du die lokale IP-Adresse der Synology ein.

Anschließend aktivierst du gleich die wichtigen Verwaltungsfunktionen:

• Update-Prüfung einschalten

Du kannst tägliche Update-Checks aktivieren und eine feste Uhrzeit festlegen.

• Automatische Container-Updates aktivieren

So werden verfügbare Updates direkt eingespielt.

• Security-Scan vorbereiten

Die Sicherheitsscanner solltest du direkt aktivieren. Sie prüfen heruntergeladene Images auf Schwachstellen und helfen dir dabei, unsaubere oder riskante Images zu erkennen.

Sicherheitsscanner installieren

Dockhand unterstützt in diesem Beispiel zwei Scanner. Beide müssen zunächst heruntergeladen werden. Das erledigst du direkt in den Einstellungen über den Pull-Vorgang.

Erst danach sind die Scanner einsatzbereit. Wenn beide aktiv sind, prüft Dockhand neue Images automatisch beim Update. Das ist besonders sinnvoll, wenn du regelmäßig Container aktualisierst und nicht blind jedes neue Image übernehmen willst.

Gerade in einer Docker-Umgebung ist das ein echter Vorteil, weil du so nicht nur Updates bekommst, sondern auch direkt eine Sicherheitsprüfung mitlaufen lässt. 🔐

Was du in Dockhand verwalten kannst

Sobald die Verbindung eingerichtet ist, kannst du in Dockhand viele Aufgaben deutlich einfacher erledigen als im klassischen Container Manager.

• Container filtern

Du kannst dir nur laufende, pausierte oder gestoppte Container anzeigen lassen.

• Details einsehen

Zu jedem Container siehst du technische Informationen, Logs, Ressourcen, Gesundheitsstatus und Sicherheitsdaten.

• Container bearbeiten

Du kannst zum Beispiel die Restart Policy ändern, Port-Mappings anpassen oder weitere Ports ergänzen.

• Konsole direkt im Container öffnen

Statt dich per SSH einzuloggen, arbeitest du direkt in einer eingebauten Konsole im Container.

• Updates einzeln oder gesammelt ausführen

Mit Check for Updates prüfst du deine Container. Mit Update All kannst du alle verfügbaren Updates zentral einspielen.

Gerade bei mehreren laufenden Diensten ist das viel komfortabler als jede Anwendung einzeln anzufassen.

Untracked Stacks editierbar machen

Ein besonders spannender Teil dieser Anleitung ist die Lösung für ältere oder untracked Stacks. Diese lassen sich oft nicht direkt in Dockhand bearbeiten, weil die YAML-Datei nicht korrekt zugeordnet ist.

Die frühere Lösung war recht aufwendig: Stack duplizieren, neu erstellen und dann erneut verwalten. Inzwischen gibt es aber einen einfacheren Weg.

• Die bessere Lösung

Du stoppst zunächst das Dockhand-Projekt im Container Manager. Danach öffnest du die YAML-Konfiguration des Dockhand-Projekts und ergänzt ein zusätzliches Volume, das auf dein Docker-Hauptverzeichnis zeigt, also zum Beispiel auf volume1/docker.

Dadurch bekommt Dockhand Zugriff auf die Ordnerstruktur deiner Docker-Projekte. Nach dem Redeploy kannst du in Dockhand bei einem Stack die passende YAML-Datei direkt auswählen. Sobald das passiert ist, ändert sich der Status auf internal. Das bedeutet: Der Stack ist jetzt sauber eingebunden und lässt sich künftig direkt in Dockhand bearbeiten.

Das ist einer der nützlichsten Tricks aus dem Video, weil du damit bestehende Projekte viel einfacher in die neue Verwaltung überführst.

Zwei Systeme in einem Dashboard verwalten

Besonders stark wird Dockhand dann, wenn du mehrere Systeme zusammenführen willst. Genau das wird hier gezeigt: eine Synology und zusätzlich eine UGREEN NAS.

Dafür wird auf dem zweiten System ein Agent installiert. Dieser Agent wird per eigenem Stack eingerichtet. In der YAML-Datei sind vor allem zwei Angaben wichtig: der Name des Agents, der Token und der verwendete Port.

version: "3.8"

services:
  hawser:
    image: ghcr.io/finsys/hawser:latest
    container_name: hawser
    restart: unless-stopped

    ports:
      - "2376:2376"

    environment:
      TOKEN: "dockhand-ugreen-2026"
      AGENT_NAME: "UGREEN-NAS"
      PORT: "2376"
      DOCKER_SOCKET: "/var/run/docker.sock"
      LOG_LEVEL: "info"

    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Danach wechselst du zurück in Dockhand auf deiner Synology und legst ein weiteres Environment an. Als Verbindungstyp wählst du diesmal den Agent-Typ. Dann trägst du die IP-Adresse des zweiten Systems, den Agent-Port und den Token ein. Nach erfolgreichem Verbindungstest wird das zweite System ebenfalls eingebunden.

Ab jetzt hast du beide Umgebungen in einer Oberfläche. Du kannst dir die Kacheln passend anordnen und so dein Dashboard an deinen Bildschirm anpassen. Das ist ideal, wenn du den Überblick über mehrere NAS-Systeme behalten willst. 🖥️🖥️

Fazit

Dockhand ist eine starke Lösung, wenn du deine Docker-Container auf der Synology sauber und zentral verwalten willst. Die Installation ist überschaubar, wenn du den Port und den Volume-Pfad korrekt setzt. Danach profitierst du direkt von mehr Übersicht, besseren Filtermöglichkeiten, integrierten Logs, direktem Container-Zugriff und komfortablen Updates.

Besonders wertvoll sind zwei Dinge: Erstens die Aktivierung der Sicherheitsscanner und zweitens der Trick, untracked Stacks durch ein zusätzliches Volume editierbar zu machen. Noch spannender wird es, wenn du mehrere NAS-Systeme betreibst und diese in einem gemeinsamen Dashboard zusammenführst.

Wenn du regelmäßig mit Docker arbeitest, kann dir Dockhand viel Verwaltungsaufwand abnehmen und dein Homelab deutlich strukturierter machen.