Introduction

amir20/dozzle is a self-hosted, lightweight application designed for real-time monitoring of Docker container logs directly in your web browser. It provides a clean and intuitive interface that simplifies log management without storing any log files locally. Key features include:

• Real-Time Logging & Monitoring: Capture live logs from your Docker containers instantly.
• Docker Swarm Support: Monitor logs from multiple nodes seamlessly within one interface.
• Multi-host Support: Connect to various remote hosts using a simple dropdown menu.
• SQL Engine: Analyze logs with SQL queries in the browser, powered by WebAssembly and DuckDB.
• Secured Agents: Ensure secure connections to remote Docker hosts for added security.
• Easy Setup: Simple to set up with minimal configuration required.

Perfect for developers and DevOps teams needing efficient log management, Dozzle offers a straightforward solution tailored for real-time diagnostics and monitoring in Docker environments.

Uses and Benefits

Amir20/dozzle is designed for real-time monitoring of Docker container logs directly in your web browser, making it an indispensable tool for developers and system administrators alike.

Primary Use Cases:

• Real-Time Logging: Instantly view log data as containers run.
• Docker Swarm Support: Monitor logs from multiple nodes within a Docker Swarm.
• Multi-host Support: Easily switch between different remote hosts using the simple interface dropdown.
• Advanced Search: Utilize intelligent fuzzy search, regex-based search, and SQL queries for efficient issue diagnosis.

Key Benefits:

• Efficiency in Troubleshooting: Quickly identify issues by filtering and searching logs in real-time.
• Security: Self-hosted solution ensures that your data remains private and secure.
• Ease of Use: Minimal setup required; a clean interface with no additional configuration needed.
• Customization Options: Flexible environment variables allow for customization according to specific needs.

By leveraging these features, amir20/dozzle offers a robust and user-friendly solution for managing Docker container logs in a variety of settings.

Docker Setup

To quickly set up amir20/dozzle in your Docker environment, follow these steps:

1. Pull the Latest Image:

   docker pull amir20/dozzle:latest

2. Run Dozzle Container: Start the dozzle container by mounting the Docker socket and exposing port 8080.

   docker run --name dozzle -d --volume=/var/run/docker.sock:/var/run/docker.sock -p 8080:8080 amir20/dozzle:latest

3. Access Dozzle: Open your web browser and navigate to http://localhost:8080/ to access the real-time logging and monitoring interface.

Common Issues

• Docker Socket Access Denied: Ensure that Docker is running and that you have the necessary permissions to mount the socket. You might need to run the container as a user with sufficient privileges.

• Port Conflict: If port 8080 is already in use, choose another port by modifying -p <your-port>:8080.

• No Logs Displayed: Check that your Docker containers are running and generating logs. You can test this by starting a simple container like docker run -d busybox tail -f /dev/null and verifying it appears in Dozzle.

By following these steps, you should be able to quickly set up dozzle for real-time log monitoring in your Docker environment.

Security Essentials

• File-Based Authentication: Enable file-based authentication using the --auth-provider flag or environment variable DOZZLE_AUTH_PROVIDER. This allows you to control access by defining users and their permissions in a configuration file.

• Forward Proxy Integration: Integrate Dozzle with a forward proxy like Authelia for enhanced security. Follow the documentation at https://dozzle.dev/guide/authentication to set this up.

• Disable Analytics: If you do not want Dozzle to collect anonymous user configurations, use the --no-analytics flag or set DOZZLE_NO_ANALYTICS=true. This prevents any tracking and preserves your privacy.