D2HA – Docker to Home Assistant

Know when your containers have updates, read what changed, update them safely and read their logs: in a small web app and in Home Assistant.

D2HA is a container that watches your Docker host. It finds the real new version of each image, shows its release notes (with breaking changes in red), updates containers keeping their settings, and lets you read and follow their logs. A Home Assistant integration brings all of it to your dashboards as native update entities.

Documentation: arborae.github.io/docker2homeassistant/guide, one page per topic: installation, updates, logs, settings, Home Assistant, Telegram, configuration, security, API and troubleshooting.

Status: 0.4 is a rewrite from scratch, focused on these few things. Older versions also managed networks, volumes and images and talked to Home Assistant over MQTT: see CHANGELOG.md.

What it does

• Real versions. The digest of each tag is read from the registry with a HEAD request (free on Docker Hub); only when it changed, D2HA reads the labels of the new image, so you see 13.2.5 → 13.3.0, not just "something changed". Private registries work through the Docker daemon. Images built locally are recognised and skipped.
• Release notes that match. The GitHub release of that exact version, found through the image org.opencontainers.image.source label, with the breaking changes highlighted.
• Safe updates. The new image is downloaded while the container keeps running, then the container is recreated with the settings you gave it: environment, volumes (anonymous ones too), networks and aliases, ports, restart policy. If the new container does not start, the old one is put back. Update one container or all of them, with live progress; closing the page does not stop an update.
• Image cleanup. Remove the images no container uses any more.
• Telegram notifications. A message when a new version is out (once per version, with the release notes and a warning for breaking changes), when a container stops with an error and when it becomes unhealthy.
• Logs. The last lines or the live stream, with search, levels in colour, wrap and download.
• Home Assistant. An integration for Home Assistant 2026.8 or later, from the Marketplace (HACS before 2026.11): an update entity for each container (install and release notes from Home Assistant), container states, counters, and buttons to check, update all and clean images.
• Private by design. Sign-in with optional two-factor authentication, no third-party requests from the browser, no environment variables or secrets shown, and an example setup where D2HA reaches Docker only through a socket proxy.
• Everywhere. Light and dark theme, English and Italian, installable as an app on phones and computers.

Release notes of the new version	Logs, live
Updating a container	On a phone

Installation

1. The container

D2HA needs Docker (Engine 24 or newer) on an amd64 or arm64 machine. Copy compose.example.yaml to a new folder as compose.yaml, read it, then:

docker compose up -d
docker logs d2ha

The log shows a setup code. Open D2HA, enter the code and create your account. The example listens on 127.0.0.1 only, so:

• in a browser on the server itself, open http://localhost:12021;
• from another computer, open an SSH tunnel first (ssh -L 12021:localhost:12021 <user>@<server>), then http://localhost:12021 on that computer;
• or go through your reverse proxy or tunnel, if you already have one.

The example starts two containers:

• d2ha, published on 127.0.0.1:12021 only: Home Assistant on the same host, a reverse proxy or a tunnel can reach it, the rest of the network cannot;
• docker-proxy (linuxserver/socket-proxy), so D2HA never touches the Docker socket: it allows only the calls D2HA needs, and no exec, volumes or networks.

Options (all optional) are listed in .env.example: the hours between checks, Telegram notifications, a GitHub token for release notes (raises the GitHub limit from 60 to 5,000 requests per hour), a read-only mode, and the Home Assistant address allowed to show D2HA in an iframe.

2. Home Assistant

1. Install the integration (it needs Home Assistant 2026.8 or later). The link above opens it in the Marketplace (or in HACS).
   • Home Assistant 2026.11 or later: open Settings → Marketplace, search for D2HA, then Install and Restart Home Assistant.
   • Home Assistant 2026.8 to 2026.10: open HACS, search for D2HA, download it and restart Home Assistant.
   • If the search does not find it, add https://github.com/arborae/ha-d2ha yourself with type Integration: Add from link in the Marketplace (the first time, it asks you to connect GitHub), or as a custom repository in HACS.
2. In D2HA, open Settings → Home Assistant and create a token.
3. In Home Assistant, Settings → Devices & services → Add integration → D2HA: enter the address of D2HA (http://127.0.0.1:12021 when Home Assistant runs on the same host with network_mode: host) and the token.

In Settings → Home Assistant you can also choose which containers appear in Home Assistant.

This is the beginning of the README. Read the rest at the original. Read the full README ↗