4.8
Dozzle
Realtime log viewer for containers. Supports Docker, Swarm and K8s.
SHARE
Screenshots (1)
Screenshot 1 of 1
Overview
Dozzle is an ultra-lightweight (~7 MB compressed container), real-time web log viewer for Docker, Docker Swarm, Podman, Colima, and Kubernetes. Engineered with a zero-overhead Go backend and a Vue 3 browser UI embedded with DuckDB-WASM, Dozzle streams container logs directly over the Docker socket with fuzzy container search, regex highlighting, SQL log querying, CPU/memory metrics, and multi-host Agent orchestration.
How It Works
Dozzle operates through structured, deterministic execution stages:
Unix Socket Log Ingestion: Connects directly to local or remote Docker, Podman, and Colima daemons via
/var/run/docker.sock without writing intermediate log files to disk.In-Memory Fuzzy Search & Regex Filtering: Indexes incoming container standard output and standard error streams in real time with millisecond fuzzy container matching and regex highlighting.
Embedded DuckDB-WASM Analytics: Runs client-side SQL queries directly against live container log streams in the browser using WebAssembly without taxing host server CPU.
Multi-Host Agent Mode & Swarm Discovery: Aggregates multi-node container clusters into a unified web console over gRPC (:7007) with split-screen multi-log tailing and forward proxy auth.
Dozzle real-time Docker container log viewer interface with split-screen live tailing and fuzzy search
Key Technical Features & Capabilities
Real-Time Zero-Storage Log Streaming: Streams live container stdout/stderr directly from
/var/run/docker.sock without saving duplicate log archives on disk.Fuzzy Search, Regex & Embedded DuckDB SQL: Filters across hundreds of running containers with fuzzy name matching, regular expressions, and interactive SQL queries powered by browser-side DuckDB-WASM.
Multi-Host Agent & Docker Swarm Modes: Aggregates logs across multiple remote Docker hosts over gRPC (:7007) or Docker Swarm global services inside a unified split-screen interface.
Enterprise Auth & Podman Rootless Support: Ships file-based authentication, forward proxy auth (Authelia/OIDC), live CPU/RAM telemetry, and stable Podman socket host discovery.
Architecture & Technology Stack
Primary Languages: Go 1.27, TypeScript, Protocol Buffers (gRPC)
Frameworks & UI Runtime: Vue 3, Vite, Bun 1.4.4, Tailwind / CodeMirror 6, DuckDB-WASM
Container & Telemetry Core:
docker/moby Client API, chi Router, k8s.io/client-go, zerologSupported Platforms: Docker (
linux/amd64, linux/arm64), Podman, Colima, Swarm, KubernetesSystem Requirements
| Specification | Minimum Requirement | Recommended Specification |
|---|---|---|
| Operating System | Docker / Podman / Kubernetes (Linux, macOS, Windows) | Latest stable release build |
| Processor Architecture | 4-Core x86_64 or Apple Silicon M1 | 8-Core Apple Silicon / Core i7+ |
| Memory (RAM) | 4 GB Unified Memory | 16 GB+ High-Speed RAM |
| Disk Space | 1 GB free SSD storage | 5 GB+ free SSD storage |
Installation & Setup Guide
Docker & Compose Deployment (Recommended)
bash
docker pull amir20/dozzle:latest docker run --name dozzle -d \ --volume=/var/run/docker.sock:/var/run/docker.sock \ -v dozzle_data:/data -p 8080:8080 amir20/dozzle:latest
Multi-Host Agent Mode
bash
docker run -v /var/run/docker.sock:/var/run/docker.sock -p 7007:7007 amir20/dozzle:latest agent
Building from Source
bash
git clone https://github.com/amir20/dozzle.git cd dozzle bun install go install tool make generate make dev
Installation & Setup Guide
Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.
How to Use & Workflow
1
Start Container: Launch Dozzle mounting
/var/run/docker.sock (or run in Swarm/Agent mode) and open http://localhost:8080.2
Search & Split Streams: Press hotkey shortcuts for fuzzy container lookup and open multiple log panes side by side for microservice debugging.
3
Run Regex & SQL Filters: Toggle regex search or query structured JSON logs client-side with the integrated DuckDB SQL console.
4
Link with dtop: Connect
dtop terminal dashboards directly to Dozzle container log URLs using clickable terminal hyperlinks.How to Use & Workflow
Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.
Troubleshooting & Common Issues
**Issue: No containers appear in Dozzle UI at
http://localhost:8080.***Cause*: Docker daemon is stopped or
/var/run/docker.sock path differs (e.g., Podman rootless socket).*Resolution*: Inspect
podman info or docker context ls and bind the exact active Unix socket path to /var/run/docker.sock.**Issue: Source build fails during
make generate.***Cause*: Missing
protoc compiler or Go tools in PATH.*Resolution*: Install
protobuf, go, bun, and run go install tool before executing make generate.How to Use & Getting Started
## Installation & Setup Guide
### Docker & Compose Deployment (Recommended)
```bash
docker pull amir20/dozzle:latest
docker run --name dozzle -d \
--volume=/var/run/docker.sock:/var/run/docker.sock \
-v dozzle_data:/data -p 8080:8080 amir20/dozzle:latest
```
### Multi-Host Agent Mode
```bash
docker run -v /var/run/docker.sock:/var/run/docker.sock -p 7007:7007 amir20/dozzle:latest agent
```
### Building from Source
```bash
git clone https://github.com/amir20/dozzle.git
cd dozzle
bun install
go install tool
make generate
make dev
```
How to Use & Getting Started
Unlock this app with 2 Redit to access verified runbooks and usage workflows.
Ready to run Dozzle?
100% Free & Open-Source native desktop software. Star the repository to support development.
