New Grimoire

Watch-Grimoire/Logging/Dozzle.md

@@ -0,0 +1,118 @@
+---
+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