34 lines
1.5 KiB
Markdown
34 lines
1.5 KiB
Markdown
# Dozzle Deployment
|
|
|
|
This repository contains the deployment configuration for **Dozzle**, a real-time, responsive log viewer for Docker containers. It provides a lightweight web interface to monitor container logs without needing to access the CLI.
|
|
|
|
## 🏗️ Architecture Overview
|
|
|
|
* **Service**: Dozzle (Real-time Log Viewer)
|
|
* **Networking**: Integrated into the `web_traffic` external network to allow access via your reverse proxy.
|
|
* **Security**: Mounts the Docker socket in read-only mode to stream logs to the dashboard.
|
|
* **CI/CD**: Automated deployment via Woodpecker CI on every push to the `main` branch.
|
|
|
|
## 📂 Repository Structure
|
|
|
|
* `docker-compose.yaml`: Defines the Dozzle service and ensures it has access to `/var/run/docker.sock`.
|
|
* `.woodpecker.yaml`: Handles the automated deployment to the host server directory.
|
|
|
|
## 🚀 Deployment
|
|
|
|
### Manual Setup
|
|
Ensure the `web_traffic` network exists before launching the stack:
|
|
```bash
|
|
docker network create web_traffic
|
|
docker compose up -d
|
|
```
|
|
|
|
### CI/CD Workflow
|
|
|
|
The Woodpecker pipeline automates the following on every push:
|
|
- Ensures the deployment directory /home/george/dozzle exists on the host.
|
|
- Syncs the repository files to the server.
|
|
- Executes a docker compose up -d with --pull always and --force-recreate to ensure the dashboard is running the latest version.
|
|
|
|
# 🛠️ Usage
|
|
Once deployed and configured in your reverse proxy (e.g., Caddy), you can view all running container logs through the web UI. Dozzle does not store any logs; it simply streams them directly from the Docker daemon. |