This repository ships the Dozzle Home Assistant App (formerly “add-on”): the full Dozzle web interface in the sidebar, behind Ingress, with Home Assistant authentication.
| Packaged app version | 0.3.11 (see dozzle/config.yaml) |
| Bundled Dozzle binary | v10.6.13 (see dozzle/Dockerfile) |
| Container image | ghcr.io/erreur32/homeassistant-dozzle |
Dozzle is a lightweight tool to stream and search Docker container logs in real time. This packaging connects to the host Docker engine via the Supervisor (docker_api), serves the UI through Ingress (ingress_stream), and can run an optional embedded agent or connect to remote agents.
Important
Not an official Dozzle project. Packaging and integration are community-maintained.
This app includes the full Dozzle UI - it is not the standalone “agent-only” add-on.
Repository scope: Home Assistant packaging for Dozzle only.
- Use the button above or add the URL manually under Settings → Apps → ⋮ → App repositories.
- Confirm Add; restart Home Assistant if the Supervisor prompts you.
- Open the App Store, find Dozzle, Install, then Start.
- Open Dozzle from the sidebar (Ingress).
homeassistant-dozzle/
├── repository.yaml # Supervisor repository metadata
├── README.md # This file (overview)
├── CHANGELOG.md # Release notes (mirrored under dozzle/)
└── dozzle/
├── config.yaml # App manifest (version, Ingress, options)
├── Dockerfile
├── rootfs/ # s6 / Bashio service
├── translations/
├── README.md # Short pointer + links
├── DOCS.md # User documentation (detailed)
└── CHANGELOG.md
| Full Dozzle UI | Sidebar + Ingress; streaming via ingress_stream |
| Docker API | List containers and tail logs (docker_api: true) |
| Embedded agent | Optional dozzle agent on port 7007 (enable_agent) |
| Agent-only mode | Set enable_master: false to run only the agent (replaces standalone dozzle-agent addon) |
| Custom TLS certs | Restrict agent connections to your own cert/key pair (agent_cert / agent_key) |
| Remote agents | Comma-separated host:port in remote_agents |
| Image registry | GHCR - see badge / releases |
Configurable in the Supervisor UI after install. Full reference: dozzle/DOCS.md.
| Option | Purpose |
|---|---|
log_level |
Process log verbosity: trace ... fatal |
filter |
Optional Docker filter (same idea as docker ps --filter) |
no_analytics |
Disable anonymous Dozzle usage stats |
enable_actions |
Allow container start/stop from the UI (use carefully) |
enable_master |
Enable the web UI (default true); set false for agent-only mode |
enable_direct_access |
Expose Dozzle on port 8088 for direct browser access without Ingress |
enable_agent |
Run embedded Dozzle agent for remote instances |
agent_hostname |
Label for this agent in remote UIs |
agent_cert |
Custom TLS cert filename in /ssl/ (see DOCS.md) |
agent_key |
Custom TLS key filename in /ssl/ (see DOCS.md) |
remote_agents |
Remote host:port list (comma-separated) |
Ports (optional): 8088 - direct web access (when enable_direct_access is true); 7007 - agent, only if the embedded agent is enabled and you map the port.
Set enable_master: false + enable_agent: true to disable the web UI and run only the agent on port 7007. This replaces the standalone dozzle-agent add-on.
- Default: open Dozzle from the menu; traffic uses Ingress on internal port 8080.
- Direct access: enable
enable_direct_accessin options, then map 8088/tcp in the Network tab. - Agent: enable in options, map 7007/tcp; connect from another Dozzle with
DOZZLE_REMOTE_AGENT=<ha-ip>:<mapped-port>.
Example environment for a standalone Dozzle container talking to remote agents:
environment:
- DOZZLE_REMOTE_AGENT=192.168.1.10:7007,192.168.1.11:7007| Resource | URL |
|---|---|
| This repository | github.com/Erreur32/homeassistant-dozzle |
| Upstream Dozzle | github.com/amir20/dozzle · dozzle.dev |
| Home Assistant Apps | developers.home-assistant.io/docs/apps |
Report issues on the GitHub issue tracker.
Pull requests and improvements are welcome.
Thanks to @JZ-SmartThings for reporting and thoroughly investigating the notification persistence issue (#1).
Packaging: Erreur32. Upstream Dozzle: Amir Raminfar and contributors.
This repo’s contributors.
Repository packaging: see LICENSE when present in the repo. Upstream Dozzle: its license.