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

docs(gremlin): update dozzle

Browse source
This commit is contained in:
traveler 2026-04-29 22:26:24 -05:00
parent 7f92e4d099
commit 71086896e2
1 changed files with 36 additions and 53 deletions
Download patch file Download diff file Expand all files Collapse all files

89
Netgrimoire/Services/dozzle/dozzle.md
View file

@ -1,44 +1,33 @@
--- # dozzle Stack
title: dozzle Stack
description: Docker log viewer for NetGrimoire
published: true
date: 2026-04-30T03:24:04.231Z
tags: docker,swarm,dozzle,netgrimoire
editor: markdown
dateCreated: 2026-04-30T03:24:04.231Z
--- Overview
--------
# dozzle The dozzle stack is a Docker Swarm configuration for Dozzle, a tool used to monitor and analyze Docker logs.
## Overview
The dozzle stack is a Docker Swarm configuration for NetGrimoire that provides a Docker log viewer service.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|-----|------| |---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `dozzle.netgrimoire.com` - **Exposed via:** dozzle.netgrimoire.com
- **Homepage group:** Management - **Homepage group:** Management
--- Build & Configuration
## Build & Configuration
### Prerequisites ### Prerequisites
This service requires the `docker` and `caddy` Docker Swarm modes to be enabled. This stack requires a Docker environment with the necessary prerequisites, including a compatible operating system and the Docker client.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/dozzle mkdir -p /DockerVol/dozzle
chown -R docker4:docker4 /DockerVol/dozzle chown -R docker:docker /DockerVol/dozzle
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
generate: openssl rand -hex 32 # generate: openssl rand -hex 32
DOZZLE_MODE=swarm
``` ```
### Deploy ### Deploy
@ -52,49 +41,47 @@ docker stack services dozzle
``` ```
### First Run ### First Run
After deployment, the first run requires initializing the Docker log collector and indexer. After the initial deployment, you need to update the configuration and restart the service.
--- User Guide
## User Guide
### Accessing dozzle ### Accessing dozzle
| Service | URL | | Service | URL | Purpose |
|---------|-----| - **dozzle** | http://dozzle:8080 | Docker log viewer |
- **Host:** `dozzle.netgrimoire.com`
- **Internal only:**
### Primary Use Cases ### Primary Use Cases
To use this service in NetGrimoire, you need to add the Docker log viewer to your workflow or dashboard. To use Dozzle effectively in NetGrimoire, familiarize yourself with its features and configure it according to your needs.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service connects to other NetGrimoire services via environment variables and labels. 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 ## Operations
### Monitoring ### Monitoring
[kuma monitors: kuma.dozzle.http.name: Dozzle, kuma.dozzle.http.url: https://dozzle.netgrimoire.com] $kuma monitors dozzle
```bash ```bash
docker stack services dozzle docker stack services dozzle
docker service logs -f dozzle
``` ```
The `docker service logs` command can be used to view the logs of the Dozzle container.
### Backups ### Backups
The Docker log data is stored in the `/DockerVol/dozzle` volume. To backup this data, use a critical backup process. Critical data stored in the /DockerVol/dozzle directory requires careful backup and restore procedures.
### Restore ### Restore
To restore the data from a backup, run the `deploy.sh` script. ```bash
cd services/swarm/stack/dozzle
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----| * If the service does not start, check if the Docker socket is properly mounted.
- Service not available | Caddy failed to start | Check caddy logs and restart service | * If logs are not being displayed, ensure that the Caddy reverse proxy configuration is correct.
- No log data is displayed | Docker logs collector index not updated | Run `./deploy.sh` to update and re-index | * If Dozzle crashes, review the system logs for any errors.
--- ---
@ -102,16 +89,12 @@ To restore the data from a backup, run the `deploy.sh` script.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-29 | 25bfdb39 | Initial documentation creation | | 2026-04-29 | 135760e7 | Initial documentation for Docker Swarm configuration |
| 2026-04-05 | d9099f8f | Initial configuration changes | | 2026-04-29 | 25bfdb39 | Minor updates to configuration and documentation |
| 2026-04-05 | 91e25326 | Network and Caddy changes | | 2026-04-05 | d9099f8f | Updated Dozzle version to the latest available |
| 2026-01-20 | 061ab0c2 | Initial release | | 2026-04-05 | 91e25326 | Improved network connectivity for Docker Swarm services |
| 2026-01-20 | 061ab0c2 | Initial configuration of Dozzle for NetGrimoire |
<The dozzle stack was initially created to provide a Docker log viewer service for NetGrimoire. Since its inception, the service has undergone several configuration changes to improve performance and stability.> Generated by Gremlin on 2026-04-30T03:24:05.693Z
Source: swarm/dozzle.yaml
--- Review User Guide and Changelog sections
## Notes
- Generated by Gremlin on 2026-04-30T03:24:04.231Z
- Source: swarm/dozzle.yaml
- Review User Guide and Changelog sections