Skip to content

Dozzle: Real-time Docker Log Viewer with Remote Agents

Dozzle is a lightweight, web-based application for monitoring Docker container logs in real-time. The core Dozzle server provides local container log monitoring, while optional agents enable monitoring of remote Docker hosts from a single interface.

Architecture Options

Standalone Server - Single Dozzle instance monitoring local containers - Perfect for single-host deployments - Minimal setup required - Direct access to Docker socket

Distributed Setup with Agents - Optional agents for monitoring remote Docker hosts - Useful for multi-host environments - Centralized log viewing across multiple servers - Reduced network overhead through local log processing

Installation

Basic Standalone Setup

services:
  dozzle:
    image: amir20/dozzle:latest
    container_name: dozzle
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Optional Agent Setup

Deploy on remote hosts you want to monitor: 

services:
  dozzle-agent:
    image: amir20/dozzle:latest
    command: agent
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - 7007:7007

Common Usage Examples

Connecting Optional Agents

Configure the main Dozzle server to connect to remote agents:

services:
  dozzle:
    environment:
      DOZZLE_REMOTE: "http://agent1:7007,http://agent2:7007"

Secure Agent Configuration

For production environments:

services:
  dozzle-agent:
    environment:
      DOZZLE_AUTH_TOKEN: "your-secure-token"

  dozzle:
    environment:
      DOZZLE_REMOTE: "http://agent1:7007?token=your-secure-token"

Additional Options

  • Deployment Flexibility:
    • Start with standalone server for simple setups
    • Add agents only when remote monitoring is needed
    • Mix local and remote monitoring as needed
  • Agent Security:
    • Use read-only Docker socket mount
    • Enable authentication tokens
    • Implement TLS for secure communication
  • Performance:
    • Agents process logs locally to reduce network load
    • Minimal resource usage on remote hosts
    • Efficient websocket-based communication

The web interface at http://localhost:8080 will show local containers by default, with remote containers appearing when agents are connected.