Real-time Docker container log viewer with Dozzle and Docker Compose.
Last updated: Oct 2026
Dozzle streams container logs to your browser in real time, with search, split views and multi-host support through lightweight agents.
Why you'd want it: Check logs from your phone without SSH or docker logs.
| Item | Value |
|---|---|
| Stack folder | /opt/stacks/dozzle |
| Category | Monitoring |
| Main image | amir20/dozzle:latest |
| Services | 1 |
| Web UI | http://<SERVER_IP>:38000 |
| Official docs | https://dozzle.dev/ |
.env/.secret files from Docker Folders and Environmentamir20/dozzle agent) on each other Docker host, on port 7007Folder layout:
/opt/stacks/
├── _shared/
│ ├── .env # shared, non-secret settings
│ └── .secret # passwords, tokens and keys (chmod 600, never commit)
└── dozzle/
└── compose.yaml
/opt/appdata/dozzle/ # persistent application data
/opt/stacks/dozzle/compose.yaml:
---
services:
dozzle:
image: amir20/dozzle:latest
container_name: dozzle
hostname: dozzle
env_file:
- /opt/stacks/_shared/.env
- /opt/stacks/_shared/.secret
environment:
- DOZZLE_REMOTE_AGENT=<AGENT_HOST_IP>:7007
- DOZZLE_HOSTNAME=<SERVER_NAME>
logging:
driver: json-file
options:
max-file: ${DOCKERLOGGING_MAXFILE:-10} # Max number of log files
max-size: ${DOCKERLOGGING_MAXSIZE:-200k} # Max file size
ports:
- 38000:8080
volumes:
- /var/run/docker.sock:/var/run/docker.sock
restart: unless-stopped
Compose reads these from the shared files with --env-file. Replace every <PLACEHOLDER> with your own value.
/opt/stacks/_shared/.env:
PUID=1000
PGID=1000
TZ=<TZ>
DOCKERLOGGING_MAXFILE=10
DOCKERLOGGING_MAXSIZE=200k
| Variable | File | Purpose | Example |
|---|---|---|---|
PUID |
.env |
User ID the container runs as (see Docker Folders) | 1000 |
PGID |
.env |
Group ID the container runs as | 1000 |
TZ |
.env |
Time zone in tz database format, e.g. America/New_York | <TZ> |
DOCKERLOGGING_MAXFILE |
.env |
Number of rotated container log files to keep | 10 |
DOCKERLOGGING_MAXSIZE |
.env |
Maximum size of each container log file | 200k |
| Host port | Container port | Protocol | Service | Purpose |
|---|---|---|---|---|
| 38000 | 8080 | tcp | dozzle |
Web UI |
| Host path | Container path | Service | Purpose |
|---|---|---|---|
/var/run/docker.sock |
/var/run/docker.sock |
dozzle |
Docker API access (grants control of Docker) |
No limits are set. This app is light, so add deploy.resources.limits only if you need to cap it.
sudo mkdir -p /opt/stacks/dozzle /opt/appdata/dozzle
sudo chown -R $USER: /opt/stacks/dozzle
/opt/stacks/_shared/.env and /opt/stacks/_shared/.secret (chmod 600 .secret)./opt/stacks/dozzle/compose.yaml.cd /opt/stacks/dozzle
docker compose --env-file ../_shared/.env --env-file ../_shared/.secret config --quiet
docker compose --env-file ../_shared/.env --env-file ../_shared/.secret up -d
docker compose logs -f.http://<SERVER_IP>:38000.DOZZLE_HOSTNAME to the name you want shown for this host.DOZZLE_REMOTE_AGENT (comma-separated host:7007).Tip: create a small wrapper such as
alias dc='docker compose --env-file /opt/stacks/_shared/.env --env-file /opt/stacks/_shared/.secret'so every stack uses the same env files.
cd /opt/stacks/dozzle
docker compose --env-file ../_shared/.env --env-file ../_shared/.secret pull
docker compose --env-file ../_shared/.env --env-file ../_shared/.secret up -d
docker image prune -f
Back up /opt/appdata/dozzle before major upgrades. Watchtower can automate updates for stateless apps.
docker compose ps and docker compose logs --tail=100.:?err): run the config command above to see which variable is not set in your env files.Educational example. Review every path, port and credential before you deploy, and never publish your .secret file.