traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Netgrimoire/Netgrimoire/Services/dozzle/dozzle.md

3.2 KiB
Raw Blame History

title description published date tags editor dateCreated
dozzle Stack Docker log viewer for NetGrimoire true 2026-04-05T05:08:49.282Z docker,swarm,dozzle,netgrimoire markdown 2026-04-05T05:08:49.282Z

dozzle

Overview

The dozzle stack is a Docker Swarm configuration for the dozzle log viewer service in NetGrimoire. It provides an interface to view and manage Docker logs.

Architecture

Service Image Port Role
  • Host: docker4
  • Network: netgrimoire
  • Exposed via: dozzle.netgrimoire.com
  • Homepage group: Management

Build & Configuration

Prerequisites

To build and deploy the dozzle stack, ensure you have Docker installed and running on your system.

Volume Setup

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

Environment Variables

# generate: openssl rand -hex 32

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

Perform the following steps after deploying the dozzle stack:

  • Verify the Caddy reverse proxy is working correctly.
  • Configure any additional security settings as needed.

User Guide

Accessing dozzle

| Service | URL | Purpose |

Primary Use Cases

To use dozzle in NetGrimoire:

  1. Log into the Caddy reverse proxy at https://dozzle.netgrimoire.com.
  2. Configure and set up your Docker logs for monitoring.

NetGrimoire Integrations

The dozzle stack integrates with other services as follows:

  • The DOZZLE_MODE environment variable is set to "swarm" to configure the service.
  • Uptime Kuma monitors the dozzle service's HTTP endpoint at https://dozzle.netgrimoire.com.

Operations

Monitoring

Use Uptime Kuma to monitor the dozzle service:

docker stack services dozzle
docker service logs -f dozzle | grep "Error"

Backups

Critical vs reconstructable Docker volumes are /DockerVol/dozzle.

Restore

To restore the dozzle stack, run ./deploy.sh from within the services/swarm/stack/dozzle directory.

Common Failures

Symptom Cause Fix
  • Service not running: Insufficient Docker resources. | - Increase resources allocated to docker4 or add more workers to the swarm configuration. |
  • Inaccessible Caddy reverse proxy: Incorrect labels on services. | - Correct caddy: and caddy.reverse_proxy labels on the dozzle service. |

Changelog

Date Commit Summary
2026-04-05 91e25326 Updated dozzle configuration to use swarm mode.
2026-01-20 061ab0c2 Initial setup of the dozzle service for NetGrimoire.

<Note: This stack was created on 2026-04-05T05:08:49.282Z and last updated on the same date due to lack of commits>

Notes

  • Generated by Gremlin on 2026-04-05T05:08:49.282Z
  • Source: swarm/dozzle.yaml