Monitoring, checked 2026-10-17
Dozzle: Docker configuration reference
Real-time Docker container log viewer with a web UI, reading logs straight from the Docker Engine API.
At a glance
- Image:
docker.io/amir20/dozzle - Tags:
latest,v11.3.2,v11.3,v11,alpine - Licence: MIT
- Source: https://github.com/amir20/dozzle
- Docs: https://dozzle.dev/guide/what-is-dozzle
Ports
| Port | What listens | Source |
|---|---|---|
8080 | HTTP listener for the web UI. Point the reverse proxy here. | source for port 8080 |
7007 (dozzle-agent) | Listener for a Dozzle agent, used when connecting Dozzle to a remote Docker host without exposing the Docker socket over the network. | source for port 7007 |
Environment variables
| Variable | Required | What it does | Example | Source |
|---|---|---|---|---|
DOZZLE_BASE | No | Mounts the UI at a sub-path instead of the root and rewrites asset URLs to match. Needed when Dozzle shares a hostname with other services behind the same proxy. | /foobar | source for DOZZLE_BASE |
DOZZLE_REMOTE_AGENT | No | Comma-separated list of Dozzle agents to connect to. Mounting the local Docker socket is then optional, and only needed to also show the local host's containers. | agent1:7007,agent2:7007 | source for DOZZLE_REMOTE_AGENT |
DOZZLE_AUTH_PROVIDER | No | Selects the auth provider: none (default), simple (users.yml), oidc or forward-proxy (github and google alias simple). Default none. | simple | source for DOZZLE_AUTH_PROVIDER |
DOZZLE_FILTER | No | Restricts which containers are shown, using the same filter syntax as docker ps. | label=com.example.app | source for DOZZLE_FILTER |
Volumes that must persist
| Path | What is in it | Source |
|---|---|---|
/var/run/docker.sock | Gives Dozzle access to container lists and logs. Getting started mounts it without :ro; the agent example uses :ro. Grants root-equivalent host access, so keep it off public networks. | source for /var/run/docker.sock |
/data | Persists Dozzle's own settings (saved filters, users) across a restart. | source for /data |
Behind a reverse proxy
- Dozzle streams logs over Server-Sent Events. The proxy must disable response buffering or logs arrive in bursts or not at all; Dozzle sends X-Accel-Buffering: no but not every proxy honours it. source for this reverse-proxy note
- Forward WebSocket upgrade headers (Upgrade, Connection) or the shell and container attach features fail to connect. source for this reverse-proxy note
- Do not compress text/event-stream responses; compression middleware, including Traefik's default compress middleware, breaks the SSE log stream. source for this reverse-proxy note
- Increase proxy read/send timeouts to several minutes; short idle timeouts on the log stream disconnect it after a few seconds of quiet logs. source for this reverse-proxy note
Release timeline
| Version | Date | Breaking | What changed | Source |
|---|---|---|---|---|
v11.3.2 | 2026-10-13 | No | Redesigned logo, merged-view actions (restart, stop, start, SQL analytics) across hosts, container table updates and new app icons. | source for release v11.3.2 |
v11.3.1 | 2026-10-10 | No | Adds container inspect from the log menu, a per-drive disk popover, ${VAR} expansion in webhook URLs and headers, and update state fixes. | source for release v11.3.1 |
v11.3.0 | 2026-10-05 | No | Adds safe updates with rollback and auto-update modes, container disk and volume sizes, reclaimable space on the host card, and split settings pages. | source for release v11.3.0 |
v11.2.0 | 2026-10-03 | No | Adds host metrics (load, disk, uptime) for hosts and agents, error memory markers in Dozzle Cloud, and a mobile disk meter. | source for release v11.2.0 |
v11.1.3 | 2026-09-29 | No | Adds multi-container updates, adding agents from the UI with an optional private certificate, and new app icons. | source for release v11.1.3 |
v11.0.0 | 2026-09-11 | Yes | Redesigned UI plus GitHub and OIDC sign-in. Sessions use a secret saved in /data, so everyone is signed out once on upgrade. | source for release v11.0.0 |
v10.10.0 | 2026-09-06 | No | Adds bundled app icons for rspamd and powerdns. | source for release v10.10.0 |
v10.9.0 | 2026-09-02 | No | Adds a check for newer container images with an update prompt, and shows app icons for well-known services. | source for release v10.9.0 |
If it is not coming up
Read from the upstream documentation, repository and container registry by Keita Emsden on 2026-10-17. Every row links the page it came from. Upstream changes without telling anyone, so check the source link before you rely on a value.