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-30 14:47:39 -05:00
parent a1c40e28e7
commit da0b89e3b6
1 changed files with 34 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,30 +1,27 @@
---
title: dozzle Stack
# dozzle Stack
description: Docker log viewer for NetGrimoire
published: true
date: 2026-04-30T04:10:27.584Z
tags: docker,swarm,dozzle,netgrimoire
editor: markdown
dateCreated: 2026-04-30T04:10:27.584Z
---
---
# dozzle
## Overview
The dozzle stack is a Docker Swarm-based service that provides a log viewer for Docker containers in NetGrimoire. It exposes the Dozzle web interface, which allows users to view and manage Docker logs.
The dozzle stack is a Docker Swarm-based service that provides a user-friendly interface for viewing Docker logs. It consists of the dozzle service, which acts as a reverse proxy and forwards requests to the Dozzle container, and the Dozzle container itself.
---
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|-------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** dozzle.netgrimoire.com, Internal only
- **Homepage group:** Management
|---------|-------|------|------|
- **dozzle** | amir20/dozzle:latest | 8080 | Reverse Proxy |
Exposed via:
- dozzle.netgrimoire.com (Caddy reverse proxy domain)
Homepage group: Monitoring
---
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
@ -39,7 +36,8 @@ chown docker4:docker4 /DockerVol/dozzle
# generate: openssl rand -hex 32
PUID=1964
PGID=1964
DOZZLE_MODE=
CADDY_domain=dozzle.netgrimoire.com
CADDY_reverse_proxy=dozzle:8080
```
### Deploy
@ -62,14 +60,13 @@ No specific post-deploy steps are required for this service.
### Accessing dozzle
| Service | URL | Purpose |
|---------|-----|---------|
- **Host:** dozzle.netgrimoire.com
- **Description:** View and manage Docker logs using Dozzle
- **dozzle** | https://dozzle.netgrimoire.com | View Docker logs |
### Primary Use Cases
To access the Dozzle web interface, navigate to `dozzle.netgrimoire.com` in a web browser. Users can view and filter Docker logs, as well as configure log filtering rules.
To view the Docker logs, navigate to the Dozzle interface at <https://dozzle.netgrimoire.com>. This will provide a user-friendly interface for viewing and filtering Docker logs.
### NetGrimoire Integrations
This service integrates with other services in NetGrimoire, including Caddy for reverse proxying and Uptime Kuma for monitoring.
This service connects to other services in NetGrimoire through environment variables and labels. The `CADDY_domain` variable is used to configure Caddy, while the `CADDY_reverse_proxy` variable is used to forward requests to the Dozzle container.
---
@ -79,11 +76,11 @@ This service integrates with other services in NetGrimoire, including Caddy for
[kuma monitors from kuma.* labels]
```bash
docker stack services dozzle
# docker service logs dozzle | tail -n 10
<docker service logs commands>
```
### Backups
Critical: `/DockerVol/dozzle` is a critical volume that requires backup. Reconstructable.
Critical vs reconstructable /DockerVol/dozzle paths should be evaluated to ensure data integrity and availability.
### Restore
```bash
@ -96,8 +93,8 @@ cd services/swarm/stack/dozzle
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- No Dozzle web interface | Image not running | `docker service start dozzle` |
- Insufficient logging permissions | Incorrect environment variables | Update PUID and PGID to match the container's UID and GID |
- dozzle service not available | Service not deployed successfully | Check `docker stack status` output for errors, and try redeploying with `set -a && source .env && set +a` before trying to access the service again. |
- Caddy fails to forward requests | Caddy configuration incorrect or missing | Review Caddy labels and ensure that they are correctly configured in the `.env` file. Try redeploying with a fresh configuration using `set -a && source .env && set +a`. |
---
@ -105,15 +102,20 @@ cd services/swarm/stack/dozzle
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-29 | 39cd6448 | Migrated to swarm configuration |
| 2026-04-29 | 083ae7fb | Updated environment variables for logging permissions |
| 2026-04-29 | 4e0c6274 | Added critical volume backup |
| 2026-04-29 | 5d6ef553 | Improved monitoring integration with Uptime Kuma |
| 2026-04-29 | 135760e7 | Updated Dozzle web interface configuration |
- 2026-04-30 | 395bc1e9 | Initial documentation and swarm configuration file generation |
- 2026-04-29 | 39cd6448 | Configuration adjustments for Dozzle service |
- 2026-04-29 | 083ae7fb | Update Caddy labels for dozzle service |
- 2026-04-29 | 4e0c6274 | Adjust environment variables for Dozzle container |
- 2026-04-29 | 5d6ef553 | Minor configuration tweaks for swarm deploy |
- 2026-04-05 | d9099f8f | Initial swarm deployment and setup |
<Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the initial documentation.>
The dozzle stack has undergone several changes in its configuration to improve functionality and stability. The most recent change was the addition of Caddy labels to ensure proper reverse proxy configuration. Additionally, environment variables have been adjusted to provide a more secure setup for the Dozzle container.
---
## Notes
Generated by Gremlin on 2026-04-30T04:10:27.584Z
Source: swarm/dozzle.yaml
Review User Guide and Changelog sections
- Generated by Gremlin on 2026-04-30T19:46:17.641Z
- Source: swarm/dozzle.yaml
- Review User Guide and Changelog sections