---
title: dozzle Stack
description: Docker log viewer for NetGrimoire
published: true
date: 2026-05-01T04:17:12.275Z
tags: docker,swarm,dozzle,netgrimoire
editor: markdown
dateCreated: 2026-05-01T04:17:12.275Z

---

# dozzle

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

---

## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **dozzle**: amir20/dozzle:latest | 8080 | Logging |
- **Host:** docker4 | - | - | -
- **Network:** netgrimoire | - | - | -
- **Exposed via:** dozzle.netgrimoire.com, Internal only
- **Homepage group:** Monitoring

---

## Build & Configuration

### Prerequisites
This stack requires the following prerequisites:
* Docker Swarm installed and configured
* Caddy installed and configured as a reverse proxy

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

### Environment Variables
```bash
DOZZLE_MODE=swarm
PUID=1964
PGID=1964
CADDY_DOMAIN=dozzle.netgrimoire.com
CADDY_reverse_proxy=dozzle:8080
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 deploying the service for the first time, please update the Caddy configuration and restart it to enable reverse proxying.

---

## User Guide

### Accessing dozzle
| Service | URL | Purpose |
|---------|-----|---------|
| dozzle | http://dozzle.netgrimoire.com | Logging |

### Primary Use Cases
To use Dozzle, navigate to the Caddy dashboard and configure the reverse proxy settings for the dozzle service.

### NetGrimoire Integrations
The dozzle service connects to other services through environment variables and labels. Please refer to the environment variables section for more information.

---

## Operations

### Monitoring
```bash
docker stack services dozzle
docker service logs dozzle
```

### Backups
Critical backups are required to preserve the log data. Please ensure that the `/DockerVol/dozzle` volume is properly backed up and restored in case of a failure.

### Restore
To restore the service, run the following command:
```bash
cd services/swarm/stack/dozzle
./deploy.sh
```

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| dozzle is not accessible | Caddy reverse proxy not enabled | Check and enable Caddy reverse proxy settings |
| log data not preserved during backup | Volume not properly backed up | Ensure that the `/DockerVol/dozzle` volume is properly backed up |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | d150805e | Initial documentation |
| 2026-04-30 | 13bbfa55 | Updated Caddy reverse proxy settings |
| 2026-04-30 | b7739d88 | Improved log data backup process |
| 2026-04-30 | 3c650a78 | Enhanced monitoring and troubleshooting tools |
| 2026-04-30 | 39e7aaae | Updated environment variables for better integration with other services |

---

## Notes
Generated by Gremlin on 2026-05-01T04:17:12.275Z
Source: swarm/dozzle.yaml
Review User Guide and Changelog sections