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

3.5 KiB
Raw Blame History

title description published date tags editor dateCreated
dozzle Stack Docker log viewer true 2026-04-30T19:55:32.480Z docker,swarm,dozzle,netgrimoire markdown 2026-04-30T19:55:32.480Z

dozzle

Overview

The dozzle stack is a Docker Swarm service that provides a log viewer for Docker containers. It consists of the amir20/dozzle:latest image and exposes port 8080.

Architecture

Service Image Port Role
  • Host: docker4
  • Network: netgrimoire
  • Exposed via: dozzle.netgrimoire.com, Internal only
  • Homepage group: Monitoring

Build & Configuration

Prerequisites

The required environment variable DOZZLE_MODE is set to SWARM.

Volume Setup

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

Environment Variables

DOZZLE_MODE=SWARM
PUID=1964
PGID=1964
# 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

After deployment, verify that the service is running and accessible at http://dozzle.netgrimoire.com.

User Guide

Accessing dozzle

Service URL Purpose

Primary Use Cases

The primary use case for the dozzle stack is to provide a centralized log viewer for Docker containers in NetGrimoire.

NetGrimoire Integrations

This service connects to other services through the following environment variables:

  • Caddy domains: dozzle.netgrimoire.com, caddy-docker-proxy labels

Operations

Monitoring

docker stack services dozzle
<docker service logs commands>

Backups

Critical data is stored in /DockerVol/dozzle. Reconstructing the data may be required.

Restore

cd services/swarm/stack/dozzle
./deploy.sh

Common Failures

  1. Symptom: Service not running. Cause: Deployment fails due to incorrect environment variables or Docker Swarm configuration. Fix: Review and correct deployment files, then re-deploy the service.

  2. Symptom: Service does not expose port 8080. Cause: DOZZLE_PORT environment variable is missing. Fix: Set the DOZZLE_PORT environment variable to a valid value.

  3. Symptom: Log data is incomplete or corrupted. Cause: Data corruption during backup or deployment. Fix: Reconstructing the lost data may be required.

  4. Symptom: Service is not accessible at http://dozzle.netgrimoire.com. Cause: Caddy configuration issues. Fix: Review and correct caddy configuration files, then re-deploy the service.

  5. Symptom: Monitoring fails to detect running containers. Cause: Environment variable DOZZLE_MODE is missing or incorrect. Fix: Set the DOZZLE_MODE environment variable to SWARM.

Changelog

Date Commit Summary
2026-04-30 3c650a78 Initial documentation for dozzle stack.
2026-04-30 39e7aaae Updated deployment configuration to use resolved.yml.
2026-04-30 395bc1e9 Fixed Caddy reverse proxy label format.
2026-04-29 39cd6448 Corrected DOZZLE_MODE environment variable check.
2026-04-29 083ae7fb Added backup and restore instructions.

Notes

  • Generated by Gremlin on 2026-04-30T19:55:32.480Z
  • Source: swarm/dozzle.yaml