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

# dozzle

## Overview
The dozzle stack is a Docker Swarm-based service that provides a log viewer for NetGrimoire. It consists of the dozzle service, which runs on docker4 and exposes its interface to Caddy via reverse proxy. The service also integrates with Uptime Kuma for monitoring.

---

## Architecture
| Service | Image | Port | Role |
|---------|-------|-----|------|
- **dozzle**: amir20/dozzle:latest | 8080 | Internal |

Exposed via: dozzle.netgrimoire.com

Homepage group: Monitoring

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/dozzle
chown -R docker4:docker4 /DockerVol/dozzle
```

### Environment Variables
```bash
DOZZLE_MODE="prod"
PUID="1964"
PGID="1964"

# generate: openssl rand -hex 32
```

### Deploy
```bash
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
Run the following command to initialize the service:
```bash
./deploy.sh
```

---

## User Guide

### Accessing dozzle
| Service | URL | Purpose |
|---------|-----|---------|
- **dozzle**: http://dozzle.netgrimoire.com:8080 | Docker log viewer |

### Primary Use Cases
Use the dozzle service to view logs for various services in NetGrimoire.

### NetGrimoire Integrations
The dozzle service integrates with other services such as Caddy and Uptime Kuma via environment variables and labels.

---

## Operations

### Monitoring
Monitor the dozzle service using Uptime Kuma.
```bash
docker stack services dozzle
docker service logs -f dozzle
```

### Backups
Critical backups should be made of critical data on /DockerVol/dozzle. Reconstructing the backup may require some time.

### Restore
Restore the service by running:
```bash
./deploy.sh
```

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- Service is not available | Docker Swarm fails to deploy | Check swarm logs and try redeploying |
- Caddy reverse proxy fails | Reverse proxy configuration incorrect | Verify Caddy labels and retry |
- Uptime Kuma monitoring fails | Monitoring configuration incorrect | Verify kuma.* labels and retry |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | 39e7aaae | Initial documentation |
| 2026-04-30 | 395bc1e9 | Update Caddy reverse proxy configuration |
| 2026-04-29 | 39cd6448 | Fix Uptime Kuma monitoring issue |
| 2026-04-29 | 083ae7fb | Update environment variables for dozzle service |
| 2026-04-29 | 4e0c6274 | Initial documentation commit |
| ... | ... | ... |

<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 since its initial documentation. The most recent change was made to update the Caddy reverse proxy configuration (commit 395bc1e9). Additionally, fixes were made to Uptime Kuma monitoring (commit 39cd6448) and environment variables for the dozzle service (commit 083ae7fb). These changes have improved the stability and functionality of the dozzle stack.

---

## Notes
- Generated by Gremlin on 2026-04-30T19:51:17.365Z
- Source: swarm/dozzle.yaml
- Review User Guide and Changelog sections