À propos
Dockhand est une intégration qui surveille et contrôle des environnements Docker via l’interface de gestion de Dockhand. Elle ajoute à Home Assistant des environnements, des conteneurs, des stacks, des réseaux, des images, des volumes et des planifications sous forme d’appareils et d’entités, en utilisant la même API que l’interface web de Dockhand. Les entités comprennent des capteurs, des capteurs binaires, des boutons pour le redémarrage, le déploiement, le redéploiement et la vérification des mises à jour, des interrupteurs pour la mise à jour automatique et le déploiement automatique, ainsi que des entités de mise à jour pour les conteneurs. Des commandes d’exécution facultatives permettent de modifier les limites de CPU, de mémoire et de processus d’un conteneur ainsi que sa politique de redémarrage, sauf pour les conteneurs gérés par Compose. Elle fonctionne en local sans aucun service cloud, et s’authentifie avec un jeton d’API ou fonctionne sans jeton lorsque l’authentification de Dockhand est désactivée. La configuration se fait dans l’interface, où les intervalles d’interrogation et des groupes de capteurs facultatifs peuvent être choisis, puis modifiés plus tard dans les options.
Résumé automatique du README et du code de raetha/ha-dockhand, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Connexion à Dockhand
- API URLL'URL de base de votre instance Dockhand.
- Vérifier le certificat SSLDécocher pour autoriser les certificats SSL auto-signés ou non approuvés. Ne désactiver que si votre instance Dockhand utilise un certificat auto-signé.
Jeton API Dockhand
- Jeton APIUn jeton API Dockhand commençant par dh_. Générez-en un sous Profil → Jetons API dans l'interface Dockhand.
Configurer l'interrogation et les fonctionnalités
- Intervalle d'interrogation rapide (secondes) — stats, conteneurs et stacksFréquence d'actualisation des conteneurs, stacks et statistiques. Défaut : 60. Minimum : 10.
- Intervalle d'interrogation lent (secondes) — images, volumes, réseaux, planificationsFréquence d'actualisation des images, volumes, réseaux et planifications. Défaut : 600. Minimum : 30.
- Activer les capteurs de planificationActive les capteurs pour les planifications de maintenance Dockhand.
- Activer les capteurs d'imagesActive les capteurs pour les images Docker par environnement.
- Activer les capteurs de volumesActive les capteurs pour les volumes Docker par environnement.
- Activer les capteurs de réseauxActive les capteurs pour les réseaux Docker par environnement.
- Activer les contrôles d'exécution (avancé)Crée des entités number/select pour modifier en direct les limites de CPU, de mémoire et de processus, ainsi que la politique de redémarrage, d'un conteneur sans pile. Non disponible pour les conteneurs gérés par Compose.
- Activer les capteurs CPU/mémoire/réseau/E-S disque par conteneur et par stackCrée des capteurs de CPU, de mémoire, de réseau et d'E/S disque pour chaque conteneur, ainsi que des totaux pour chaque stack. Désactivé par défaut, car cela représente beaucoup d'entités dont la plupart des utilisateurs n'ont pas besoin ; le désactiver supprime aussi celles déjà créées.
- Activer les entités de mise à jourCrée une entité de mise à jour Home Assistant pour chaque conteneur. Désactivez cette option si vous gérez les mises à jour autrement et ne voulez pas que les conteneurs de Dockhand apparaissent dans la gestion des mises à jour de HA. Masque aussi le bouton « Tout mettre à jour » ; « Vérifier les mises à jour » continue de fonctionner quand même.
- Activer les versions de mise à jour précisesMet à niveau les entités de mise à jour pour afficher des numéros de version précis (digests d'image) via des requêtes de registre périodiques, au lieu d'une simple étiquette d'image. C'est aussi le seul moyen de voir l'état de mise à jour des propres conteneurs protégés de Dockhand (lui-même et Hawser) — Dockhand n'expose jamais leur état de mise à jour via ses données habituelles de vérification de mise à jour en cache. Nécessite « Activer les entités de mise à jour » ci-dessus.
- Intervalle de vérification des mises à jour précises (secondes)Fréquence d'exécution des requêtes de registre ci-dessus (secondes). Par défaut : 86400 (24 heures). Minimum : 300.
Ré-authentification avec Dockhand
- Jeton APIUn jeton API Dockhand commençant par dh_.
Reconfigurer Dockhand
- API URLL'URL de base de votre instance Dockhand.
- Vérifier le certificat SSLDécocher pour autoriser les certificats SSL auto-signés ou non approuvés.
- Jeton APIVotre token actuel est affiché masqué. Effacez-le et sauvegardez pour désactiver l'authentification (vous serez à nouveau invité si le serveur l'exige toujours). Saisissez une nouvelle valeur pour faire pivoter les identifiants.
Après la mise en place
- Intervalle d'interrogation rapide (secondes) — stats, conteneurs et stacksFréquence d'actualisation des conteneurs, stacks et statistiques. Défaut : 60. Minimum : 10.
- Intervalle d'interrogation lent (secondes) — images, volumes, réseaux, planificationsFréquence d'actualisation des images, volumes, réseaux et planifications. Défaut : 600. Minimum : 30.
- Activer les capteurs de planificationActive les capteurs pour les planifications de maintenance Dockhand.
- Activer les capteurs d'imagesActive les capteurs pour les images Docker par environnement.
- Activer les capteurs de volumesActive les capteurs pour les volumes Docker par environnement.
- Activer les capteurs de réseauxActive les capteurs pour les réseaux Docker par environnement.
- Activer les contrôles d'exécution (avancé)Crée des entités number/select pour modifier en direct les limites de CPU, de mémoire et de processus, ainsi que la politique de redémarrage, d'un conteneur sans pile. Non disponible pour les conteneurs gérés par Compose.
- Activer les capteurs CPU/mémoire/réseau/E-S disque par conteneur et par stackCrée des capteurs de CPU, de mémoire, de réseau et d'E/S disque pour chaque conteneur, ainsi que des totaux pour chaque stack. Désactivé par défaut, car cela représente beaucoup d'entités dont la plupart des utilisateurs n'ont pas besoin ; le désactiver supprime aussi celles déjà créées.
- Activer les entités de mise à jourCrée une entité de mise à jour Home Assistant pour chaque conteneur. Désactivez cette option si vous gérez les mises à jour autrement et ne voulez pas que les conteneurs de Dockhand apparaissent dans la gestion des mises à jour de HA. Masque aussi le bouton « Tout mettre à jour » ; « Vérifier les mises à jour » continue de fonctionner quand même.
- Activer les versions de mise à jour précisesMet à niveau les entités de mise à jour pour afficher des numéros de version précis (digests d'image) via des requêtes de registre périodiques, au lieu d'une simple étiquette d'image. C'est aussi le seul moyen de voir l'état de mise à jour des propres conteneurs protégés de Dockhand (lui-même et Hawser) — Dockhand n'expose jamais leur état de mise à jour via ses données habituelles de vérification de mise à jour en cache. Nécessite « Activer les entités de mise à jour » ci-dessus.
- Intervalle de vérification des mises à jour précises (secondes)Fréquence d'exécution des requêtes de registre ci-dessus (secondes). Par défaut : 86400 (24 heures). Minimum : 300.
Textes issus du code de raetha/ha-dockhand.
Entités
- Capteurs binairesEn ligne, Collecte d'activité, Collecte de métriques, Analyse des vulnérabilités, Vérification des mises à jour, Mise à jour automatique, Élagage des images, Erreur de synchronisation, Mises à jour disponibles
- BoutonsRechercher des mises à jour d'images, Redémarrer, Déployer, Redéployer, Mettre à jour tous les conteneurs
- NombresLimite de mémoire, Limite de CPU, Limite de processus
- SélecteursPolitique de redémarrage
- CapteursUtilisation CPU, Utilisation mémoire, Conteneurs, Stacks, Nombre d'images, Nombre de volumes, Nombre de réseaux, Utilisation du disque, Événements d'activité, État, Santé, Statut et 16 autres
- InterrupteursMise à jour automatique, Déploiement automatique
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Dockhand ne peut pas accéder à une partie de ses données
Extrait du 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.
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 181 partagent leurs statistiques
- Étoiles GitHub
- 48
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v1.11.0,
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
dockhand- Problèmes
- Signaler un problème
