diff --git a/Netgrimoire/Services/dozzle/dozzle.md b/Netgrimoire/Services/dozzle/dozzle.md
index d721073..5fc0d54 100644
--- a/Netgrimoire/Services/dozzle/dozzle.md
+++ b/Netgrimoire/Services/dozzle/dozzle.md
@@ -2,49 +2,44 @@
title: dozzle Stack
description: Docker log viewer for NetGrimoire
published: true
-date: 2026-04-30T04:08:58.369Z
+date: 2026-04-30T04:10:27.584Z
tags: docker,swarm,dozzle,netgrimoire
editor: markdown
-dateCreated: 2026-04-30T04:08:58.369Z
+dateCreated: 2026-04-30T04:10:27.584Z
---
# dozzle
## Overview
-The dozzle stack is a Docker Swarm configuration that provides a log viewer service for NetGrimoire. The primary services included in this stack are Docker, Caddy, and Uptime Kuma.
+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.
## Architecture
| Service | Image | Port | Role |
-|---------|-------|------|------|
-| Host | docker4 |
-| Network | netgrimoire |
-| Exposed via | dozzle.netgrimoire.com, Internal only |
-| Homepage group | Management |
+|---------|-------|------|-------|
+- **Host:** docker4
+- **Network:** netgrimoire
+- **Exposed via:** dozzle.netgrimoire.com, Internal only
+- **Homepage group:** Management
---
## Build & Configuration
### Prerequisites
-- Ensure Docker is installed and running on the manager node.
+No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/dozzle
-chown docker:docker /DockerVol/dozzle
+chown docker4:docker4 /DockerVol/dozzle
```
### Environment Variables
```bash
+# generate: openssl rand -hex 32
PUID=1964
PGID=1964
-
-# generate:
-openssl rand -hex 32 > DOZZLE_TOKEN
-
-DOZZLE_MODE=swarm
-CADDY_URL=dozzle.netgrimoire.com:443
-CADDY Reverse_proxy=dozzle:8080
+DOZZLE_MODE=
```
### Deploy
@@ -58,7 +53,7 @@ docker stack services dozzle
```
### First Run
-No specific steps required during the initial deployment.
+No specific post-deploy steps are required for this service.
---
@@ -67,35 +62,42 @@ No specific steps required during the initial deployment.
### Accessing dozzle
| Service | URL | Purpose |
|---------|-----|---------|
-- Caddy reverse proxy: dozzle.netgrimoire.com
-- Internal access only
+- **Host:** dozzle.netgrimoire.com
+- **Description:** View and manage Docker logs using Dozzle
### Primary Use Cases
-1. View Docker logs.
-2. Configure and monitor the dozzle service.
+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.
### NetGrimoire Integrations
-- Uptime Kuma for monitoring.
+This service integrates with other services in NetGrimoire, including Caddy for reverse proxying and Uptime Kuma for monitoring.
---
## Operations
### Monitoring
+[kuma monitors from kuma.* labels]
```bash
docker stack services dozzle
+# docker service logs dozzle | tail -n 10
+```
+
+### Backups
+Critical: `/DockerVol/dozzle` is a critical volume that requires backup. Reconstructable.
+
+### Restore
+```bash
+cd services/swarm/stack/dozzle
+./deploy.sh
```
-- `docker service logs dozzle`
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
-| Failed to Deploy | Docker Swarm failed to deploy services. | Ensure docker is running, and check for errors with "docker service create --config dozzle-stack.yml". |
-| Accessing dozzle Fails | Caddy reverse proxy configuration issues. | Check the caddy configuration logs or restart caddy.
-| dozzle doesn't work | Docker log file not being read by dozzle | Ensure that docker service container has a writable /var/log directory.|
-| Failed to Log in to dozzle| Invalid CADDY_URL | Check that the DOZZLE_TOKEN is correct and regenerate if needed.
+- 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 |
---
@@ -103,19 +105,15 @@ docker stack services dozzle
| Date | Commit | Summary |
|------|--------|---------|
-| 2026-04-29 | 083ae7fb | Initial dozzle Stack configuration |
-| 2026-04-29 | 4e0c6274 | Minor updates to Caddy and Kuma integration. |
-| 2026-04-29 | 5d6ef553 | Update DOZZLE_TOKEN generation mechanism. |
-| 2026-04-29 | 135760e7 | Initial logging configuration. |
-| 2026-04-29 | 25bfdb39 | Fix for docker volume permissions in initial deploy. |
-| 2026-04-05 | d9099f8f | Updated DOZZLE_TOKEN generation mechanism |
-| 2026-04-05 | 91e25326 | Minor updates to dozzle service configuration |
-| 2026-01-20 | 061ab0c2 | Initial swarm deployment. |
-| 2026-01-10 | 1a374911 | Initial environment variable setup |
+| 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 |
---
## Notes
-- Generated by Gremlin on 2026-04-30T04:08:58.369Z
-- Source: swarm/dozzle.yaml
-- Review User Guide and Changelog sections
\ No newline at end of file
+Generated by Gremlin on 2026-04-30T04:10:27.584Z
+Source: swarm/dozzle.yaml
+Review User Guide and Changelog sections
\ No newline at end of file