Überblick
Dockhand ist eine Integration, die Docker-Umgebungen über die Dockhand-Verwaltungsoberfläche überwacht und steuert. Sie fügt Umgebungen, Container, Stacks, Netzwerke, Images, Volumes und Zeitpläne als Geräte und Entitäten zu Home Assistant hinzu und nutzt dafür dieselbe API wie die Dockhand-Weboberfläche. Zu den Entitäten gehören Sensoren, Binärsensoren, Tasten für Neustart, Deploy, erneutes Deploy und Update-Prüfungen, Schalter für automatische Updates und automatisches Deploy sowie Update-Entitäten für Container. Optionale Laufzeitsteuerungen erlauben es, die Grenzen für CPU, Arbeitsspeicher und Prozesse sowie die Neustart-Richtlinie eines Containers zu ändern, außer bei Containern, die von Compose verwaltet werden. Sie arbeitet lokal ohne Cloud-Dienste und authentifiziert sich mit einem API-Token oder läuft ohne Token, wenn die Dockhand-Authentifizierung deaktiviert ist. Die Einrichtung erfolgt in der Oberfläche, wo Abfrageintervalle und optionale Sensorgruppen gewählt und später in den Optionen geändert werden können.
Zusammenfassung der README und des Codes von raetha/ha-dockhand, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Mit Dockhand verbinden
- API URLDie Basis-URL deiner Dockhand-Instanz.
- SSL-Zertifikat überprüfenDeaktivieren, um selbstsignierte oder nicht vertrauenswürdige SSL-Zertifikate zuzulassen. Nur deaktivieren, wenn deine Dockhand-Instanz ein selbstsigniertes Zertifikat verwendet.
Dockhand API-Token
- API-TokenEin Dockhand API-Token, das mit dh_ beginnt. Erstelle eines unter Profil → API-Tokens in der Dockhand-Oberfläche.
Abfrage und Funktionen konfigurieren
- Schnelles Abfrageintervall (Sekunden) – Stats, Container & StacksWie oft Container-, Stack- und Umgebungsstatistiken aktualisiert werden. Standard: 60. Minimum: 10.
- Langsames Abfrageintervall (Sekunden) – Images, Volumes, Netzwerke, SchedulesWie oft Images, Volumes, Netzwerke und Schedules aktualisiert werden. Standard: 600. Minimum: 30.
- Schedule-Sensoren aktivierenAktiviert Sensoren für Dockhand-Wartungspläne.
- Image-Sensoren aktivierenAktiviert Sensoren für Docker-Images je Umgebung.
- Volume-Sensoren aktivierenAktiviert Sensoren für Docker-Volumes je Umgebung.
- Netzwerk-Sensoren aktivierenAktiviert Sensoren für Docker-Netzwerke je Umgebung.
- Laufzeitsteuerung aktivieren (erweitert)Erstellt Number-/Select-Entitäten, um CPU-, Speicher- und Prozesslimits sowie die Neustart-Richtlinie eines Stack-losen Containers live zu ändern. Nicht verfügbar für Compose-verwaltete Container.
- CPU-/Speicher-/Netzwerk-/Festplatten-E/A-Sensoren für Container und Stacks aktivierenErstellt CPU-, Speicher-, Netzwerk- und Festplatten-I/O-Sensoren pro Container sowie Summen pro Stack. Standardmäßig deaktiviert, da es sich um viele Entitäten handelt, die die meisten Nutzer nicht benötigen; das Deaktivieren entfernt auch bereits erstellte Sensoren.
- Update-Entitäten aktivierenErstellt eine Home-Assistant-Update-Entität für jeden Container. Deaktivieren Sie dies, wenn Sie Updates auf andere Weise verwalten und Dockhands Container nicht in HAs eigener Update-Verwaltung sehen möchten. Blendet auch die Schaltfläche „Alle aktualisieren“ aus; „Nach Updates suchen“ funktioniert trotzdem weiter.
- Präzise Update-Versionen aktivierenAktualisiert Update-Entitäten so, dass sie über regelmäßige Registry-Abfragen präzise Versionsnummern (Image-Digests) anzeigen, statt nur eines Image-Tags. Außerdem die einzige Möglichkeit, den Update-Status von Dockhands eigenen geschützten Containern (es selbst und Hawser) zu sehen – Dockhand gibt deren Update-Status nie über die regulären zwischengespeicherten Update-Check-Daten preis. Erfordert „Update-Entitäten aktivieren“ oben.
- Prüfintervall für präzise Updates (Sekunden)Wie oft die obigen Registry-Abfragen ausgeführt werden (Sekunden). Standard: 86400 (24 Stunden). Minimum: 300.
Erneute Authentifizierung mit Dockhand
- API-TokenEin Dockhand API-Token, das mit dh_ beginnt.
Dockhand neu konfigurieren
- API URLDie Basis-URL deiner Dockhand-Instanz.
- SSL-Zertifikat überprüfenDeaktivieren, um selbstsignierte oder nicht vertrauenswürdige SSL-Zertifikate zuzulassen.
- API-TokenDein aktuelles Token wird maskiert angezeigt. Leere es und speichere, um die Authentifizierung zu deaktivieren (du wirst erneut aufgefordert, wenn der Server sie noch benötigt). Gib einen neuen Wert ein, um die Anmeldedaten zu rotieren.
Nach der Einrichtung
- Schnelles Abfrageintervall (Sekunden) – Stats, Container & StacksWie oft Container-, Stack- und Umgebungsstatistiken aktualisiert werden. Standard: 60. Minimum: 10.
- Langsames Abfrageintervall (Sekunden) – Images, Volumes, Netzwerke, SchedulesWie oft Images, Volumes, Netzwerke und Schedules aktualisiert werden. Standard: 600. Minimum: 30.
- Schedule-Sensoren aktivierenAktiviert Sensoren für Dockhand-Wartungspläne.
- Image-Sensoren aktivierenAktiviert Sensoren für Docker-Images je Umgebung.
- Volume-Sensoren aktivierenAktiviert Sensoren für Docker-Volumes je Umgebung.
- Netzwerk-Sensoren aktivierenAktiviert Sensoren für Docker-Netzwerke je Umgebung.
- Laufzeitsteuerung aktivieren (erweitert)Erstellt Number-/Select-Entitäten, um CPU-, Speicher- und Prozesslimits sowie die Neustart-Richtlinie eines Stack-losen Containers live zu ändern. Nicht verfügbar für Compose-verwaltete Container.
- CPU-/Speicher-/Netzwerk-/Festplatten-E/A-Sensoren für Container und Stacks aktivierenErstellt CPU-, Speicher-, Netzwerk- und Festplatten-I/O-Sensoren pro Container sowie Summen pro Stack. Standardmäßig deaktiviert, da es sich um viele Entitäten handelt, die die meisten Nutzer nicht benötigen; das Deaktivieren entfernt auch bereits erstellte Sensoren.
- Update-Entitäten aktivierenErstellt eine Home-Assistant-Update-Entität für jeden Container. Deaktivieren Sie dies, wenn Sie Updates auf andere Weise verwalten und Dockhands Container nicht in HAs eigener Update-Verwaltung sehen möchten. Blendet auch die Schaltfläche „Alle aktualisieren“ aus; „Nach Updates suchen“ funktioniert trotzdem weiter.
- Präzise Update-Versionen aktivierenAktualisiert Update-Entitäten so, dass sie über regelmäßige Registry-Abfragen präzise Versionsnummern (Image-Digests) anzeigen, statt nur eines Image-Tags. Außerdem die einzige Möglichkeit, den Update-Status von Dockhands eigenen geschützten Containern (es selbst und Hawser) zu sehen – Dockhand gibt deren Update-Status nie über die regulären zwischengespeicherten Update-Check-Daten preis. Erfordert „Update-Entitäten aktivieren“ oben.
- Prüfintervall für präzise Updates (Sekunden)Wie oft die obigen Registry-Abfragen ausgeführt werden (Sekunden). Standard: 86400 (24 Stunden). Minimum: 300.
Texte aus dem Code von raetha/ha-dockhand.
Entitäten
- BinärsensorenOnline, Aktivitätserfassung, Metrikenerfassung, Schwachstellen-Scan, Update-Prüfungen, Automatisches Update, Image-Bereinigung, Synchronisierungsfehler, Updates verfügbar
- TastenNach Image-Updates suchen, Neu starten, Bereitstellen, Neu bereitstellen, Alle Container aktualisieren
- ZahlenSpeicherlimit, CPU-Limit, Prozesslimit
- AuswahlfelderNeustartrichtlinie
- SensorenCPU-Auslastung, Speicherauslastung, Container, Stacks, Image-Anzahl, Volume-Anzahl, Netzwerk-Anzahl, Speicherplatznutzung, Aktivitätsereignisse, Zustand, Gesundheit, Status und 16 weitere
- SchalterAutomatische Aktualisierung, Automatische Bereitstellung
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Dockhand kann einen Teil seiner Daten nicht erreichen
Aus der README
Monitor and control your Docker environments through Dockhand — a modern Docker management UI. This integration exposes environments, containers, stacks, networks, images, volumes, and schedules as Home Assistant devices and entities, using the same API as the Dockhand web UI.
No cloud services are used. Supports API token authentication and works with Dockhand instances where authentication is disabled.
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 181 teilen Analysedaten
- GitHub-Sterne
- 48
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v1.11.0,
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
dockhand- Probleme
- Problem melden
