Dockhand for Home Assistant

Dockhand for Home Assistant

The Dockhand integration brings support for the Dockhand Docker management platform to Home Assistant, allowing you to monitor and manage your Docker infrastructure alongside the rest of your smart home and homelab.

Alongside the integration, Dockhand Cards provides a collection of dashboard cards designed to give you an at-a-glance operational view of your Dockhand environment.

Together, these projects bring Docker service health, container status, update availability, and infrastructure visibility into Home Assistant dashboards, automations, and notifications.

Quick links: Dockhand Integration · Dockhand Cards · Requirements · Installation


Dockhand Integration

The integration connects directly to the Dockhand API and exposes your Docker environment as Home Assistant devices and entities.

Features

  • Native Home Assistant config flow

  • Support for multiple Dockhand instances

  • Discovery of Docker containers and Compose stacks

  • Container and stack status monitoring

  • Container and stack lifecycle controls:

    • Start
    • Stop
    • Restart
    • Update
  • Update entities for monitoring available Docker image updates

  • Trigger container updates directly from Home Assistant including vulnerability scanning if enabled

  • Entity data available for dashboards, automations, scripts, and notifications

  • Integration with the Home Assistant device and entity model

The update entities allow Home Assistant to become part of your container maintenance workflow. You can monitor which containers have available updates, create notifications, and trigger updates without leaving Home Assistant.

Whether you are managing a handful of services on a homelab server or a larger Docker environment, the goal is to make Docker infrastructure a first-class part of Home Assistant.


Dockhand Cards

Dockhand Cards is a companion dashboard card collection built specifically for the Dockhand integration.

The focus of the cards is providing an operational dashboard for your Docker environment rather than replacing Home Assistant’s standard entity controls.

Dockhand Cards makes it easy to see the overall state of your environment at a glance, including service health, container status, and available updates.

Features

  • Dashboard-oriented views of Dockhand status
  • Container and stack health visibility
  • Update availability indicators
  • Integration with Dockhand update entities
  • Clean, information-dense layouts for homelab monitoring
  • Purpose-built presentation of Dockhand data inside Home Assistant

Screenshots

Environment


Vulnerability

Stack

Container

Stacks

Containers

Updates


Why Dockhand?

Dockhand is a modern Docker management platform with support for container management, Compose stacks, and multi-environment Docker management.

Until now, there has not been a native Home Assistant integration specifically for Dockhand.

As far as I am aware, this is the first complete Home Assistant integration built specifically for Dockhand, providing native Home Assistant entities, automation support, update monitoring, and dashboard integration.


Requirements

  • Home Assistant 2026.3 or newer

  • Python 3.14 (included with supported Home Assistant releases)

  • Dockhand 1.0.26 or newer for API token authentication

    • Installations without authentication are supported on any Dockhand version

Installation

Both projects are available through HACS as custom repositories.

Dockhand Integration

Install Dockhand Integration via HACS

Add the repository as a custom integration repository in HACS, install it, and configure your Dockhand instance through Home Assistant.

Dockhand Cards

Install Dockhand Cards via HACS

Add the repository as a custom dashboard card repository in HACS and install the cards you would like to use.


Both projects are open source. Feedback, feature requests, bug reports, and contributions are welcome.

If you are using Dockhand with Home Assistant, I would love to hear how you are using it and what features you would like to see added in the future.

1 Like

How to connect to ad dock and homeassistant app

URL is 192.168.2.179:8123/app/469b7386_dockhand

Hi @dvbit. I’ve not used the Dockhand App on HAOS myself, but it should be fairly simple if the container is exposed to HA. When you go to the specific app page and scroll down a little it lists the hostname. Assuming a default port of 3000 you’d end up with a url something like:
http://469b7386-dockhand:3000

That said, I’m assuming the container is on the same docker bridge network as HA itself, and that the api path isn’t being filtered in some way by the App configuration. If it doesn’t just work once you have the right hostname and port, you might need to contact the maintainer for the HA App and ask them how to get a URL that points directly to the API without going through the HA proxy that wraps the Dockhand UI into an HA interface. They might need to modify the App configuration to support this.

If you do get it working, I’d love to know the steps so I can add them to my readme for others.

No success . I will get in touch with the dev

Did you try port 8099 by any chance? It looks like that container is using nginx around Dockhand, and listening on that port.