Dozzle - dozzle.dev
Dozzle is a small lightweight application with a web based interface to monitor Docker logs. It doesn’t store any log files. It is for live monitoring of your container logs only.
dozzle-dark.mp4
- Intelligent fuzzy search for container names 🤖
- Search logs using regex 🔦
- Small memory footprint 🏎
- Split screen for viewing multiple logs
- Download logs easily
- Live stats with memory and CPU usage
- Multi-user authentication with support for proxy forward authorization 🚨
Dozzle has been tested with hundreds of containers. However, it doesn't support offline searching. Products like Loggly, Papertrail or Kibana are more suited for full search capabilities.
Dozzle is a small container (4 MB compressed). Pull the latest release with:
$ docker pull amir20/dozzle:latest
The simplest way to use dozzle is to run the docker container. Also, mount the Docker Unix socket with --volume to /var/run/docker.sock:
$ docker run --name dozzle -d --volume=/var/run/docker.sock:/var/run/docker.sock -p 8888:8080 amir20/dozzle:latest
Dozzle will be available at http://localhost:8888/.
Here is the Docker Compose file:
version: "3"
services:
dozzle:
container_name: dozzle
image: amir20/dozzle:latest
volumes:
- /var/run/docker.sock:/var/run/docker.sock
ports:
- 8888:8080
For advanced options like authentication, remote hosts or common questions see documentation at dozzle.dev.
Dozzle users automatic API negotiation which works with most Docker configurations. Dozzle also works with Colima and Podman.
By default Podman doesn't have a background process but you can enable this for Dozzle to work.
Verify first if your podman installation has enabled remote socket:
podman info
When you get under the key remote socket output like this, its already enabled:
remoteSocket:
exists: true
path: /run/user/1000/podman/podman.sock
If it's not enabled please follow this tutorial to enable it.
Once you have the podman remote socket you can run Dozzle on podman.
podman run --volume=/run/user/1000/podman/podman.sock:/var/run/docker.sock -d -p 8888:8080 amir20/dozzle:latest
Dozzle supports file based authentication and forward proxy like Authelia. These are documented at https://dozzle.dev/guide/authentication.
Dozzle collects anonymous user configurations using Google Analytics. Why? Dozzle is an open source project with no funding. As a result, there is no time to do user studies of Dozzle. Analytics is collected to prioritize features and fixes based on how people use Dozzle. This data is completely public and can be viewed live using Data Studio dashboard.
If you do not want to be tracked at all, see the --no-analytics flag below.
Dozzle follows the 12-factor model. Configurations can use the CLI flags or environment variables. The table below outlines all supported options and their respective env vars.
| Flag | Env Variable | Default |
|---|---|---|
--addr |
DOZZLE_ADDR |
:8080 |
--base |
DOZZLE_BASE |
/ |
--hostname |
DOZZLE_HOSTNAME |
"" |
--level |
DOZZLE_LEVEL |
info |
--auth-provider |
DOZZLE_AUTH_PROVIDER |
none |
--auth-header-user |
DOZZLE_AUTH_HEADER_USER |
Remote-User |
--auth-header-email |
DOZZLE_AUTH_HEADER_EMAIL |
Remote-Email |
--auth-header-name |
DOZZLE_AUTH_HEADER_NAME |
Remote-Name |
--enable-actions |
DOZZLE_ENABLE_ACTIONS |
false |
--wait-for-docker-seconds |
DOZZLE_WAIT_FOR_DOCKER_SECONDS |
0 |
--filter |
DOZZLE_FILTER |
"" |
--no-analytics |
DOZZLE_NO_ANALYTICS |
false |
--remote-host |
DOZZLE_REMOTE_HOST |
There are many ways you can support Dozzle:
- Use it! Write about it! Star it! If you love Dozzle, drop me a line and tell me what you love.
- Blog about Dozzle to spread the word. If you are good at writing send PRs to improve the documentation at dozzle.dev
- Sponsor my work at https://www.buymeacoffee.com/amirraminfar
To Build and test locally: