https://github.com/unklab-id/dozzle
This repository contains the Docker Compose configuration for running Dozzle, a real-time log viewer for Docker containers.
https://github.com/unklab-id/dozzle
docker docker-compose dozzle
Last synced: 2 months ago
JSON representation
This repository contains the Docker Compose configuration for running Dozzle, a real-time log viewer for Docker containers.
- Host: GitHub
- URL: https://github.com/unklab-id/dozzle
- Owner: UNKLAB-ID
- Created: 2024-10-22T11:02:55.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-05-22T15:55:43.000Z (about 1 year ago)
- Last Synced: 2025-06-14T17:04:26.766Z (about 1 year ago)
- Topics: docker, docker-compose, dozzle
- Homepage: https://dozzle.unklab.id
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dozzle Docker Setup
This repository contains the Docker Compose configuration for running Dozzle, a real-time log viewer for Docker containers.
## Overview
Dozzle is a simple, lightweight application that helps you monitor your Docker container logs in real-time through a web interface. This setup includes configuration for connecting to a remote Docker agent.
## Prerequisites
- Docker Engine installed
- Docker Compose V2+ installed
- Access to Docker socket
- Network access to remote Docker agent (if using remote configuration)
## Configuration
### Docker Compose
The setup uses Docker Compose with version 3 of the compose specification. Here's the configuration breakdown:
```yaml
version: "3"
networks:
unklab:
external: true
services:
dozzle:
image: amir20/dozzle:latest
container_name: dozzle
restart: unless-stopped
environment:
- DOZZLE_REMOTE_AGENT=10.104.0.3:7007
volumes:
- /var/run/docker.sock:/var/run/docker.sock
networks:
- unklab
```
### Key Components
1. **Networks**:
- Uses an external network named `unklab`
- External networks must be created before running this compose file
2. **Service Configuration**:
- Container name: `dozzle`
- Image: `amir20/dozzle:latest`
- Restart policy: `unless-stopped`
3. **Environment Variables**:
- `DOZZLE_REMOTE_AGENT`: Set to `10.104.0.3:7007` for remote agent connection
4. **Volumes**:
- Mounts Docker socket for container log access
- Mount path: `/var/run/docker.sock:/var/run/docker.sock`
## Installation
1. Clone this repository:
```bash
git clone [repository-url]
cd [repository-name]
```
2. Create the required external network (if not already existing):
```bash
docker network create unklab
```
3. Start the container:
```bash
docker compose up -d
```
## Usage
Once the container is running, you can access the Dozzle web interface through your browser. The default port is typically 8080, but you may need to check your specific configuration.
### Monitoring Logs
1. Open your web browser
2. Navigate to the Dozzle interface
3. View real-time logs for all your Docker containers
## Maintenance
### Updating
To update to the latest version of Dozzle:
```bash
docker compose pull
docker compose up -d
```
### Stopping the Service
To stop Dozzle:
```bash
docker compose down
```
## Troubleshooting
Common issues and solutions:
1. **Docker Socket Access Issues**:
- Ensure proper permissions on `/var/run/docker.sock`
- Check if the user has proper group membership
2. **Network Connectivity**:
- Verify the remote agent address is correct
- Check if the port 7007 is accessible
- Ensure the `unklab` network exists and is properly configured
3. **Container Won't Start**:
- Check logs using `docker compose logs dozzle`
- Verify all required networks are available
- Ensure Docker socket is accessible
## Contributing
1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request
## Support
For issues and feature requests, please file an issue in the GitHub repository.