---
title: dozzle Stack
description: Docker log viewer for NetGrimoire
published: true
date: 2026-05-05T20:16:08.910Z
tags: docker,swarm,dozzle,netgrimoire
editor: markdown
dateCreated: 2026-05-05T20:16:08.910Z

---

# dozzle

## Overview
The dozzle stack is a Docker Swarm service that provides a log viewer for NetGrimoire. It exposes the Dozzle application, which allows users to view and manage logs from various sources.

## Architecture
| Service | Image | Port | Role |
|---------|-------|-----|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** dozzle.netgrimoire.com
- **Homepage group:** Monitoring

---

## Build & Configuration

### Prerequisites
The swarm configuration requires the following prerequisites:
- Docker Swarm manager and worker setup
- Caddy reverse proxy and Uptime Kuma monitoring setup
- Properly configured environment variables for authentication and authorization

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

### Environment Variables
```bash
# generate: openssl rand -hex 32
DOZZLE_MODE=swarm
PUID=1964
PGID=1964
CADDY ReverseProxy=dozzle.netgrimoire.com
CADDY_import_1=crowdsec
CADDY_import_2=authentik
```

### 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
After deployment, the Dozzle application should be accessible at dozzle.netgrimoire.com.

---

## User Guide

### Accessing dozzle
| Service | URL |
|---------|-----|
- **URL:** dozzle.netgrimoire.com
- **Purpose:** View and manage logs from various sources

### Primary Use Cases
To use the Dozzle log viewer in NetGrimoire:
1. Navigate to the Dozzle web interface.
2. Select a source (e.g., Docker container) to view its logs.
3. Configure filters, timestamps, and other settings as needed.

### NetGrimoire Integrations
The dozzle stack integrates with the following services:
- Authentik (for authentication)
- Crowdsec (for threat detection)

---

## Operations

### Monitoring
Kuma monitors are available for this service:
```bash
docker stack services dozzle
docker service logs -f dozzle
```

### Backups
Critical data is stored in the /DockerVol/dozzle directory.

### Restore
To restore from a backup, re-run the deploy script:
```bash
cd services/swarm/stack/dozzle
./deploy.sh
```

---

## Common Failures
| Symptom | Cause | Fix |
|---------|------|-----|
1. **No logs visible** | Incorrect authentication credentials | Check authentik and crowdsec setup.
2. **Service not responding** | Container not running | Restart the dozzle service.
3. **Authentication issues** | Incorrect CADDY settings | Review and correct environment variables.

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-05-05 | 4c7304f5 | Initial documentation for dozzle stack |
| 2026-05-01 | c3b0c0f5 | Updated Dozzle configuration |
| 2026-04-30 | d150805e | Initial deployment and setup |

<No changes available from the diffs above>

---

## Notes
- Generated by Gremlin on 2026-05-05T20:16:08.910Z
- Source: swarm/dozzle.yaml
- Review User Guide and Changelog sections