diff --git a/Netgrimoire/Services/dozzle/dozzle.md b/Netgrimoire/Services/dozzle/dozzle.md new file mode 100644 index 0000000..9e82143 --- /dev/null +++ b/Netgrimoire/Services/dozzle/dozzle.md @@ -0,0 +1,117 @@ +--- +title: dozzle Stack +description: Docker log viewer for NetGrimoire +published: true +date: 2026-04-30T03:24:04.231Z +tags: docker,swarm,dozzle,netgrimoire +editor: markdown +dateCreated: 2026-04-30T03:24:04.231Z + +--- + +# dozzle + +## Overview +The dozzle stack is a Docker Swarm configuration for NetGrimoire that provides a Docker log viewer service. + +--- +## Architecture +| Service | Image | Port | Role | +|---------|-------|-----|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** `dozzle.netgrimoire.com` +- **Homepage group:** Management + +--- + +## Build & Configuration + +### Prerequisites +This service requires the `docker` and `caddy` Docker Swarm modes to be enabled. + +### Volume Setup +```bash +mkdir -p /DockerVol/dozzle +chown -R docker4:docker4 /DockerVol/dozzle +``` + +### Environment Variables +```bash +generate: openssl rand -hex 32 +``` + +### 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 +After deployment, the first run requires initializing the Docker log collector and indexer. + +--- + +## User Guide + +### Accessing dozzle +| Service | URL | +|---------|-----| +- **Host:** `dozzle.netgrimoire.com` +- **Internal only:** + +### Primary Use Cases +To use this service in NetGrimoire, you need to add the Docker log viewer to your workflow or dashboard. + +### NetGrimoire Integrations +This service connects to other NetGrimoire services via environment variables and labels. + +--- + +## Operations + +### Monitoring +[kuma monitors: kuma.dozzle.http.name: Dozzle, kuma.dozzle.http.url: https://dozzle.netgrimoire.com] + +```bash +docker stack services dozzle +docker service logs -f dozzle +``` + +### Backups +The Docker log data is stored in the `/DockerVol/dozzle` volume. To backup this data, use a critical backup process. + +### Restore +To restore the data from a backup, run the `deploy.sh` script. + +--- + +## Common Failures +| Symptom | Cause | Fix | +|---------|-------|-----| +- Service not available | Caddy failed to start | Check caddy logs and restart service | +- No log data is displayed | Docker logs collector index not updated | Run `./deploy.sh` to update and re-index | + +--- + +## Changelog + +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-29 | 25bfdb39 | Initial documentation creation | +| 2026-04-05 | d9099f8f | Initial configuration changes | +| 2026-04-05 | 91e25326 | Network and Caddy changes | +| 2026-01-20 | 061ab0c2 | Initial release | + + + +--- + +## Notes +- Generated by Gremlin on 2026-04-30T03:24:04.231Z +- Source: swarm/dozzle.yaml +- Review User Guide and Changelog sections \ No newline at end of file