Netgrimoire/Netgrimoire/Services/dozzle/dozzle.md

dozzle Stack

Overview

The dozzle stack is a Docker Swarm configuration for Dozzle, a tool used to monitor and analyze Docker logs.

Architecture

Service	Image	Port	Role

• Host: docker4
• Network: netgrimoire
• Exposed via: dozzle.netgrimoire.com
• Homepage group: Management

Build & Configuration

Prerequisites

This stack requires a Docker environment with the necessary prerequisites, including a compatible operating system and the Docker client.

Volume Setup

mkdir -p /DockerVol/dozzle
chown -R docker:docker /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

After the initial deployment, you need to update the configuration and restart the service.

User Guide

Accessing dozzle

| Service | URL | Purpose |

• dozzle | http://dozzle:8080 | Docker log viewer |

Primary Use Cases

To use Dozzle effectively in NetGrimoire, familiarize yourself with its features and configure it according to your needs.

NetGrimoire Integrations

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 dozzle

docker stack services dozzle

The docker service logs command can be used to view the logs of the Dozzle container.

Backups

Critical data stored in the /DockerVol/dozzle directory requires careful backup and restore procedures.

Restore

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

---

Common Failures

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

---

Changelog

Date	Commit	Summary
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

Generated by Gremlin on 2026-04-30T03:24:05.693Z Source: swarm/dozzle.yaml Review User Guide and Changelog sections