diff --git a/Netgrimoire/Services/dozzle/dozzle.md b/Netgrimoire/Services/dozzle/dozzle.md index 9e82143..09ee2a0 100644 --- a/Netgrimoire/Services/dozzle/dozzle.md +++ b/Netgrimoire/Services/dozzle/dozzle.md @@ -1,44 +1,33 @@ ---- -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 Stack ---- +Overview +-------- -# dozzle +The dozzle stack is a Docker Swarm configuration for Dozzle, a tool used to monitor and analyze Docker logs. -## 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` +- **Exposed via:** dozzle.netgrimoire.com - **Homepage group:** Management ---- - -## Build & Configuration +Build & Configuration ### Prerequisites -This service requires the `docker` and `caddy` Docker Swarm modes to be enabled. +This stack requires a Docker environment with the necessary prerequisites, including a compatible operating system and the Docker client. ### Volume Setup ```bash mkdir -p /DockerVol/dozzle -chown -R docker4:docker4 /DockerVol/dozzle +chown -R docker:docker /DockerVol/dozzle ``` ### Environment Variables ```bash -generate: openssl rand -hex 32 +# generate: openssl rand -hex 32 +DOZZLE_MODE=swarm ``` ### Deploy @@ -52,49 +41,47 @@ docker stack services dozzle ``` ### First Run -After deployment, the first run requires initializing the Docker log collector and indexer. +After the initial deployment, you need to update the configuration and restart the service. ---- - -## User Guide +User Guide ### Accessing dozzle -| Service | URL | -|---------|-----| -- **Host:** `dozzle.netgrimoire.com` -- **Internal only:** +| Service | URL | Purpose | +- **dozzle** | http://dozzle:8080 | Docker log viewer | ### Primary Use Cases -To use this service in NetGrimoire, you need to add the Docker log viewer to your workflow or dashboard. +To use Dozzle effectively in NetGrimoire, familiarize yourself with its features and configure it according to your needs. ### NetGrimoire Integrations -This service connects to other NetGrimoire services via environment variables and labels. +This service integrates with other services in NetGrimoire, including the reverse proxy and monitoring systems. The DOZZLE_MODE environment variable indicates that this is a Swarm configuration. --- ## Operations ### Monitoring -[kuma monitors: kuma.dozzle.http.name: Dozzle, kuma.dozzle.http.url: https://dozzle.netgrimoire.com] - +$kuma monitors dozzle ```bash docker stack services dozzle -docker service logs -f dozzle ``` +The `docker service logs` command can be used to view the logs of the Dozzle container. ### Backups -The Docker log data is stored in the `/DockerVol/dozzle` volume. To backup this data, use a critical backup process. +Critical data stored in the /DockerVol/dozzle directory requires careful backup and restore procedures. ### Restore -To restore the data from a backup, run the `deploy.sh` script. +```bash +cd services/swarm/stack/dozzle +./deploy.sh +``` --- ## 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 | + +* If the service does not start, check if the Docker socket is properly mounted. +* If logs are not being displayed, ensure that the Caddy reverse proxy configuration is correct. +* If Dozzle crashes, review the system logs for any errors. --- @@ -102,16 +89,12 @@ To restore the data from a backup, run the `deploy.sh` script. | 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 | +| 2026-04-29 | 135760e7 | Initial documentation for Docker Swarm configuration | +| 2026-04-29 | 25bfdb39 | Minor updates to configuration and documentation | +| 2026-04-05 | d9099f8f | Updated Dozzle version to the latest available | +| 2026-04-05 | 91e25326 | Improved network connectivity for Docker Swarm services | +| 2026-01-20 | 061ab0c2 | Initial configuration of Dozzle for NetGrimoire | - - ---- - -## 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 +Generated by Gremlin on 2026-04-30T03:24:05.693Z +Source: swarm/dozzle.yaml +Review User Guide and Changelog sections \ No newline at end of file