--- title: "Dockhand" description: "Dockhand is a Marketplace integration for Home Assistant. It has 181 installs sharing analytics, works locally and was last updated October 19, 2026." canonical: "https://vulpo.app/integrations/marketplace/raetha-ha-dockhand" url: "https://vulpo.app/integrations/marketplace/raetha-ha-dockhand.md" last-updated: "2026-10-22" version: "1.4" --- # Dockhand > Dockhand is a Marketplace integration for Home Assistant. It has 181 installs sharing analytics, works locally and was last updated October 19, 2026. Dockhand is an integration that monitors and controls Docker environments through the Dockhand management UI. It adds environments, containers, stacks, networks, images, volumes, and schedules to Home Assistant as devices and entities, using the same API as the Dockhand web interface. Entities include sensors, binary sensors, buttons for restart, deploy, redeploy and update checks, switches for auto update and auto deploy, and update entities for containers. Optional runtime controls let a container's CPU, memory, and process limits and restart policy be changed, except for Compose-managed containers. It works locally with no cloud services, and authenticates with an API token or runs without one when Dockhand authentication is disabled. Setup happens in the UI, where poll intervals and optional sensor groups can be chosen and later changed in options. Automatic summary of the README and code of raetha/ha-dockhand. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=raetha&repository=ha-dockhand&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=raetha&repository=ha-dockhand&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connect to Dockhand - **API URL**: The base URL of your Dockhand instance. - **Verify SSL certificate**: Uncheck to allow self-signed or untrusted SSL certificates. Only disable if your Dockhand instance uses a self-signed cert. ### Dockhand API Token - **API Token**: A Dockhand API token starting with dh\_. Generate one under Profile → API tokens in the Dockhand UI. ### Configure polling and features - **Fast poll interval (seconds) — stats, containers & stacks**: How often to refresh container, stack, and environment stats. Default: 60. Minimum: 10. - **Slow poll interval (seconds) — images, volumes, networks, schedules**: How often to refresh images, volumes, networks, and schedules. Default: 600. Minimum: 30. - **Enable schedule sensors**: Enables sensors for Dockhand maintenance schedules. - **Enable image sensors**: Enables sensors for Docker images on each environment. - **Enable volume sensors**: Enables sensors for Docker volumes on each environment. - **Enable network sensors**: Enables sensors for Docker networks on each environment. - **Enable runtime controls (advanced)**: Creates number/select entities to change a stack-less container's CPU, memory, and process limits, and restart policy, live. Not available for Compose-managed containers. - **Enable container and stack CPU/memory/network/disk I/O sensors**: Creates CPU, memory, network, and disk I/O sensors for each container, plus totals for each stack. Off by default since it's a lot of entities most people don't need; turning it off also removes any already-created ones. - **Enable update entities**: Creates a Home Assistant update entity for every container. Turn this off if you manage updates another way and don't want Dockhand's containers in HA's own update management. Also hides the 'Update all' button; 'Check for updates' keeps working either way. - **Enable precise update versions**: Upgrades update entities to show precise version numbers (image digests) via periodic registry queries, instead of just an image tag. Also the only way to see update status for Dockhand's own protected containers (itself and Hawser) — Dockhand never exposes their update status through its regular cached update-check data. Requires 'Enable update entities' above. - **Precise update check interval (seconds)**: How often to run the registry queries above (seconds). Default: 86400 (24 hours). Minimum: 300. ### Re-authenticate with Dockhand - **API Token**: A Dockhand API token starting with dh\_. ### Reconfigure Dockhand - **API URL**: The base URL of your Dockhand instance. - **Verify SSL certificate**: Uncheck to allow self-signed or untrusted SSL certificates. - **API Token**: Your current token is shown masked. Clear it and save to disable authentication (you will be prompted again if the server still requires it). Enter a new value to rotate credentials. ### After setup - **Fast poll interval (seconds) — stats, containers & stacks**: How often to refresh container, stack, and environment stats. Default: 60. Minimum: 10. - **Slow poll interval (seconds) — images, volumes, networks, schedules**: How often to refresh images, volumes, networks, and schedules. Default: 600. Minimum: 30. - **Enable schedule sensors**: Enables sensors for Dockhand maintenance schedules. - **Enable image sensors**: Enables sensors for Docker images on each environment. - **Enable volume sensors**: Enables sensors for Docker volumes on each environment. - **Enable network sensors**: Enables sensors for Docker networks on each environment. - **Enable runtime controls (advanced)**: Creates number/select entities to change a stack-less container's CPU, memory, and process limits, and restart policy, live. Not available for Compose-managed containers. - **Enable container and stack CPU/memory/network/disk I/O sensors**: Creates CPU, memory, network, and disk I/O sensors for each container, plus totals for each stack. Off by default since it's a lot of entities most people don't need; turning it off also removes any already-created ones. - **Enable update entities**: Creates a Home Assistant update entity for every container. Turn this off if you manage updates another way and don't want Dockhand's containers in HA's own update management. Also hides the 'Update all' button; 'Check for updates' keeps working either way. - **Enable precise update versions**: Upgrades update entities to show precise version numbers (image digests) via periodic registry queries, instead of just an image tag. Also the only way to see update status for Dockhand's own protected containers (itself and Hawser) — Dockhand never exposes their update status through its regular cached update-check data. Requires 'Enable update entities' above. - **Precise update check interval (seconds)**: How often to run the registry queries above (seconds). Default: 86400 (24 hours). Minimum: 300. Texts from the code of [raetha/ha-dockhand](https://github.com/raetha/ha-dockhand). ## Entities - **Binary sensors**: Online, Activity collection, Metrics collection, Vulnerability scanning, Update checks, Auto update, Image pruning, Sync error, Updates available - **Buttons**: Check for image updates, Restart, Deploy, Redeploy, Update all containers - **Numbers**: Memory limit, CPU limit, Process limit - **Selects**: Restart policy - **Sensors**: CPU usage, Memory usage, Containers, Stacks, Image count, Volume count, Network count, Disk usage, Activity events, State, Health, Status, and 16 more - **Switches**: Auto update, Auto deploy ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Dockhand can't reach part of its data ## From the 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. From the README of [raetha/ha-dockhand](https://github.com/raetha/ha-dockhand#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Number: 181 installs sharing analytics; 48 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.11.0, last updated October 19, 2026 - Domain: `dockhand` - Source: - Issues: In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/raetha-ha-dockhand --- - HTML version of this page: https://vulpo.app/integrations/marketplace/raetha-ha-dockhand - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml