Netgrimoire/Watch-Grimoire/Logging/Dozzle.md
2026-04-12 09:53:51 -05:00

2.8 KiB

title description published date tags editor dateCreated
dozzle Stack Docker log viewer for NetGrimoire true 2026-04-05T05:10:20.507Z docker,swarm,dozzle,netgrimoire markdown 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

mkdir -p /DockerVol/dozzle
chown dozer:dozer /DockerVol/dozzle

Environment Variables

generate: openssl rand -hex 32 DOZZLE_MODE=swarm

Deploy

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:

./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:

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:

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:

./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