Dockhand — Home Assistant add-on / app

Share your Projects! Custom Integrations
1

Hi everyone — I packaged Dockhand as a Home Assistant add-on so you can run a modern web UI to manage Docker directly from your Home Assistant host.

Repository (add-on): https://github.com/netscout2001/ha-dockhand

What this add-on does

This add-on runs the upstream Dockhand server inside a supervised Home Assistant add-on container so you get a full browser UI for:

  • real-time container lifecycle and stats
  • Compose stack management and YAML editor
  • image / volume / network management
  • interactive terminal and multi-container logs
  • file browser and file operations inside containers
  • Git/GitOps deploys, registry browsing and more

These are the core features of the upstream project.

Key features (at a glance)

  • Start / stop / restart / inspect containers
  • Visual Compose stack editor and stack deploys
  • Terminal, logs viewer, and live resource metrics
  • File browser, file upload/download inside containers
  • Multi-environment/agent support (manage remote hosts via an agent)
    (See upstream docs for the full feature list.)

Previews

Screenshots above show the Dockhand dashboard, containers list, stack editor and file browser (taken from the upstream Dockhand site/docs).

Installation (Home Assistant)

  1. In Home Assistant → Supervisor → Add-on Store → Repositories add:
  1. Install the Dockhand add-on.
  2. Deactivate “Safe mode” in the add-on options (required for socket access).
  3. Start the add-on.
  4. Open the Web UI at:

http://<HOME_ASSISTANT_HOST>:3000

  1. In Dockhand → Settings → Environments: set the socket path to /run/docker.sock (or use Autodetect).

Important notes & security

  • For full functionality Dockhand needs access to the Docker API (usually via /var/run/docker.sock or /run/docker.sock). Mounting the host Docker socket into the add-on grants control of Docker — that’s powerful but risky. Only enable this on trusted hosts.
  • You may need to disable Home Assistant “Safe mode” for the add-on to use the socket.
  • If you want to manage remote Docker hosts without mounting the socket, look into the upstream agent/edge options (Hawser) for secure remote connections.

Versioning / notes

  • Add-on uses x.x.x-X format: first three numbers track upstream Dockhand version; trailing -X is add-on specific.

Troubleshooting

  • If the add-on doesn’t start: check for port conflicts (default port 3000) and look at the add-on logs.
  • For socket problems: ensure the socket path is correct and the add-on has the necessary permissions.

Support

If you find bugs or need help, please open an issue on the add-on repo (include add-on logs and a short description) — that’s the fastest way to get a fix.

GitHub (add-on): https://github.com/netscout2001/ha-dockhand
Upstream Dockhand (project / docs): https://github.com/Finsys/dockhand — full docs and features.

1 Like
2

Will it identify and remedy network issues, a lot of those reported here on these forums and related to docker misconfiguration?

3

I haven’t noticed any mistakes so far.

4

This has been great! Thanks for your work as I was literally looking for this over Portainer the day before finding this project. It is possible to enable Ingress for this?

1 Like
5

Ingress is not supported by the dockhand. I tried it already.

6

Thats disappointing, but perhaps one day. Thats the most immediate thing missing for me since I’m accessing HA remotely much of the time. Thanks again regardless.

7

I wanted to share that I just spend a week working on a Dockhand integration with Home Assistant to work with this. Note that Claude was used for a significant portion of the coding and debugging, but I’d love feedback if anyone finds this useful. It is pretty similar to the Portainer integration, though with limits based on Dockhand’s current API.

4 Likes
8

Nice.
Sensors for ram and cpu would be nice per container. Then i can delete portainer. :wink:

9

Nice work! Thank you so much for this

10

thanks so much for this addon, I want to unistall portainer, in the portainer integration unfortunately it adds all containers on your setup, it’s overwhelming and I only want to manage few minimal containers via home assistant.

11

would be possible to only install hawser agent on HA as addon? (newly apps)