https://github.com/erreur32/homeassistant-dozzle
[Dozzle] for Homeassistant.
https://github.com/erreur32/homeassistant-dozzle
dozzle homeassistant homeassistant-addons
Last synced: 3 months ago
JSON representation
[Dozzle] for Homeassistant.
- Host: GitHub
- URL: https://github.com/erreur32/homeassistant-dozzle
- Owner: Erreur32
- Created: 2026-04-05T19:17:20.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-05T21:18:18.000Z (3 months ago)
- Last Synced: 2026-04-05T21:23:18.107Z (3 months ago)
- Topics: dozzle, homeassistant, homeassistant-addons
- Language: Shell
- Homepage:
- Size: 115 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Home Assistant Add-on Repository: Dozzle
Dozzle
Real-time Docker logs in Home Assistant - full web UI, Ingress, optional agent.
[![Release][release-shield]][release]
![Project Stage][project-stage-shield]
![Project Maintenance][maintenance-shield]
[![License][license-shield]][license]
[![Issues][issues-shield]][issue]
[![Stargazers][stars-shield]][stars]
---
## About
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.3` (see [`dozzle/config.yaml`](dozzle/config.yaml)) |
| **Bundled Dozzle binary** | `v10.4.1` (see [`dozzle/Dockerfile`](dozzle/Dockerfile)) |
| **Container image** | `ghcr.io/erreur32/homeassistant-dozzle` |
[Dozzle](https://github.com/amir20/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.
---
## Quick start
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FErreur32%2Fhomeassistant-dozzle)
1. Use the button above **or** add the URL manually under **Settings → Apps → ⋮ → App repositories**.
2. Confirm **Add**; restart Home Assistant if the Supervisor prompts you.
3. Open the [App Store](https://my.home-assistant.io/redirect/supervisor_store/), find **Dozzle**, **Install**, then **Start**.
4. Open **Dozzle** from the sidebar (Ingress).
---
## Repository layout
```
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
```
---
## Features
| | |
| --- | --- |
| 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 |
---
## Configuration (summary)
Configurable in the Supervisor UI after install. Full reference: [`dozzle/DOCS.md`](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.
### Agent-only mode
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](https://github.com/Erreur32/homeassistant-dozzle-agent) add-on.
---
## Usage
- **Default:** open **Dozzle** from the menu; traffic uses **Ingress** on internal port **8080**.
- **Direct access:** enable `enable_direct_access` in options, then map **8088/tcp** in the Network tab.
- **Agent:** enable in options, map **7007/tcp**; connect from another Dozzle with `DOZZLE_REMOTE_AGENT=:`.
Example environment for a standalone Dozzle container talking to remote agents:
```yaml
environment:
- DOZZLE_REMOTE_AGENT=192.168.1.10:7007,192.168.1.11:7007
```
---
## Links
| Resource | URL |
| --- | --- |
| This repository | [github.com/Erreur32/homeassistant-dozzle](https://github.com/Erreur32/homeassistant-dozzle) |
| Upstream Dozzle | [github.com/amir20/dozzle](https://github.com/amir20/dozzle) · [dozzle.dev](https://dozzle.dev) |
| Home Assistant Apps | [developers.home-assistant.io/docs/apps](https://developers.home-assistant.io/docs/apps/) |
---
## Support
Report issues on the [GitHub issue tracker][issue].
## Contributing
Pull requests and improvements are welcome.
## Acknowledgments
Thanks to [@JZ-SmartThings](https://github.com/JZ-SmartThings) for reporting and thoroughly investigating the notification persistence issue ([#1](https://github.com/Erreur32/homeassistant-dozzle/issues/1)).
## Authors
Packaging: [Erreur32][erreur32]. Upstream Dozzle: [Amir Raminfar](https://github.com/amir20) and [contributors](https://github.com/amir20/dozzle/graphs/contributors).
This repo’s [contributors](https://github.com/Erreur32/homeassistant-dozzle/graphs/contributors).
## License
Repository packaging: see [LICENSE][license] when present in the repo. Upstream Dozzle: [its license](https://github.com/amir20/dozzle/blob/main/LICENSE).
---
[contributors]: https://github.com/Erreur32/homeassistant-dozzle/graphs/contributors
[erreur32]: https://github.com/Erreur32
[issue]: https://github.com/Erreur32/homeassistant-dozzle/issues
[license]: https://github.com/Erreur32/homeassistant-dozzle/blob/main/LICENSE
[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
[project-stage-shield]: https://img.shields.io/badge/project%20stage-stable-green.svg
[release-shield]: https://img.shields.io/badge/version-v0.3.3-blue.svg
[release]: https://github.com/Erreur32/homeassistant-dozzle/releases/tag/v0.3.3
[license-shield]: https://img.shields.io/badge/license-MIT-blue.svg
[issues-shield]: https://img.shields.io/github/issues/Erreur32/homeassistant-dozzle.svg
[stars-shield]: https://img.shields.io/github/stars/Erreur32/homeassistant-dozzle.svg
[stars]: https://github.com/Erreur32/homeassistant-dozzle/stargazers