118 lines
No EOL
2.8 KiB
Markdown
118 lines
No EOL
2.8 KiB
Markdown
---
|
|
title: dozzle Stack
|
|
description: Docker log viewer for NetGrimoire
|
|
published: true
|
|
date: 2026-04-05T05:10:20.507Z
|
|
tags: docker,swarm,dozzle,netgrimoire
|
|
editor: markdown
|
|
dateCreated: 2026-04-05T05:10:20.507Z
|
|
---
|
|
|
|
# dozzle
|
|
|
|
## Overview
|
|
The dozzle stack provides a Docker log viewer for NetGrimoire, allowing users to view and manage container logs in one place.
|
|
|
|
## Architecture
|
|
| Service | Image | Port | Role |
|
|
|- **Host:** docker4 |
|
|
|- **Network:** netgrimoire |
|
|
|- **Exposed via:** caddy.netgrimoire.com |
|
|
- **Homepage group:** Management |
|
|
|
|
---
|
|
|
|
## Build & Configuration
|
|
|
|
### Prerequisites
|
|
Ensure Docker is installed and configured on the host machine.
|
|
|
|
### Volume Setup
|
|
```bash
|
|
mkdir -p /DockerVol/dozzle
|
|
chown dozer:dozer /DockerVol/dozzle
|
|
```
|
|
|
|
### Environment Variables
|
|
```bash
|
|
generate: openssl rand -hex 32 DOZZLE_MODE=swarm
|
|
```
|
|
|
|
### Deploy
|
|
```bash
|
|
cd services/swarm/stack/dozzle
|
|
set -a && source .env && set +a
|
|
docker stack config --compose-file dozzle-stack.yml > resolved.yml
|
|
docker stack deploy --compose-file resolved.yml dozzle
|
|
rm resolved.yml
|
|
docker stack services dozzle
|
|
```
|
|
|
|
### First Run
|
|
Run the following command to initialize the stack:
|
|
```bash
|
|
./deploy.sh
|
|
```
|
|
|
|
---
|
|
|
|
## User Guide
|
|
|
|
### Accessing dozzle
|
|
| Service | URL | Purpose |
|
|
|- **Dozzle** | https://dozzle.netgrimoire.com | Docker log viewer |
|
|
|
|
### Primary Use Cases
|
|
To view logs for a specific container, use the following command:
|
|
```bash
|
|
docker logs <container_id> --tail 100
|
|
```
|
|
|
|
### NetGrimoire Integrations
|
|
This stack integrates with Uptime Kuma and Caddy to provide monitoring and reverse proxy capabilities.
|
|
|
|
---
|
|
|
|
## Operations
|
|
|
|
### Monitoring
|
|
Monitor service using kuma:
|
|
```bash
|
|
docker stack services dozzle
|
|
docker service logs -f dozzle
|
|
```
|
|
|
|
### Backups
|
|
Critical data is stored on the Docker volume at /DockerVol/dozzle.
|
|
|
|
### Restore
|
|
Restore the stack by running the following command:
|
|
```bash
|
|
./deploy.sh
|
|
```
|
|
|
|
---
|
|
|
|
## Common Failures
|
|
| Failure Mode | Symptom | Cause | Fix |
|
|
|- **Container log not available** | Logs are empty or missing. | Incorrect container ID or permissions issue. | Verify container ID and ensure necessary permissions. |
|
|
|- **Caddy not started** | Caddy is not responding to requests. | Caddy service is not running. | Run `docker stack services dozzle` and verify that Caddy is running. |
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
| Date | Commit | Summary |
|
|
|------|--------|---------|
|
|
| 2026-04-05 | d9099f8f | Initial documentation creation. |
|
|
| 2026-04-05 | 91e25326 | Added volume setup and environment variable generation commands. |
|
|
| 2026-01-20 | 061ab0c2 | Initial commit for dozzle stack configuration. |
|
|
|
|
<Note: This is the initial documentation for the dozzle stack, and no further changes have been made at this time.>
|
|
|
|
---
|
|
|
|
## Notes
|
|
- Generated by Gremlin on 2026-04-05T05:10:20.507Z
|
|
- Source: swarm/dozzle.yaml
|
|
- Review User Guide and Changelog sections |