Dozzle on Raspberry Pi

Dozzle is a lightweight, open‑source, web‑based log viewer for Docker containers that streams logs in real time through a simple browser interface. It’s designed to make monitoring and debugging containers easier without needing to constantly run docker logs in the terminal.

NOTE: This guide will walk through setting the Pi up for either a Dozzle server or as an agent.

🔍 What Dozzle Does

🚀 Docker Installation Steps

  1. Update your system
    sudo apt update && sudo apt upgrade -y
  2. Install Docker
    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
  3. Install Docker Compose
    sudo apt install docker-compose-plugin
  4. Add your user to the Docker group
    sudo usermod -aG docker $USER
  5. Enable Docker at boot
    sudo systemctl enable docker
  6. Reboot
    sudo reboot
  7. Test Docker
    docker run hello-world

📁 Setup Dozzle

        mkdir ~/docker
        mkdir ~/docker/dozzle

🧾 Docker Compose File

Setting up a Dozzle server:

In ~/docker/dozzle create docker-compose.yml

services:
  dozzle:
    container_name: dozzle
    image: amir20/dozzle:v8.14.3
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
     DOZZLE_REMOTE_AGENT: 192.168.xx.xx:7007,192.168.xx.xx:7007 # Use the IP addresses of your Dozzle agents
    ports:
      - "7000:8080"
    restart: unless-stopped

Setting up a Dozzle agent:

In ~/docker/dozzle create docker-compose.yml

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

▶️ Start Dozzle

From within ~/docker/dozzle run:

docker compose up -d

📜 View Logs

For the dozzle server:

docker logs beszel

For the dozzle agent:

docker logs beszel-agent

🌐 Access Web Interface

If running your Pi as a server:

Open your browser and go to "http://<your-pi-IP-address>:7000. You should see your Pi and any agents you created listed.

If running your Pi as an agent:

Open your browser and go to "http://<your-dozzle-server>:7000. You should see your Pi and any agents you created listed.

If you find my content useful, please consider supporting this page:

☕ Buy Me a Coffee