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

# dozzle

## Overview
The dozzle stack is a Docker Swarm service that provides a log viewer for Docker containers. It consists of the amir20/dozzle:latest image and exposes port 8080.

## Architecture

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

---

## Build & Configuration

### Prerequisites
The required environment variable DOZZLE_MODE is set to SWARM.

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

### Environment Variables
```bash
DOZZLE_MODE=SWARM
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
After deployment, verify that the service is running and accessible at http://dozzle.netgrimoire.com.

---

## User Guide

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

### Primary Use Cases
The primary use case for the dozzle stack is to provide a centralized log viewer for Docker containers in NetGrimoire.

### NetGrimoire Integrations
This service connects to other services through the following environment variables:
- Caddy domains: dozzle.netgrimoire.com, caddy-docker-proxy labels

---

## Operations

### Monitoring
```bash
docker stack services dozzle
<docker service logs commands>
```

### Backups
Critical data is stored in /DockerVol/dozzle. Reconstructing the data may be required.

### Restore
```bash
cd services/swarm/stack/dozzle
./deploy.sh
```

---

## Common Failures
1. Symptom: Service not running.
Cause: Deployment fails due to incorrect environment variables or Docker Swarm configuration.
Fix: Review and correct deployment files, then re-deploy the service.

2. Symptom: Service does not expose port 8080.
Cause: DOZZLE_PORT environment variable is missing.
Fix: Set the DOZZLE_PORT environment variable to a valid value.

3. Symptom: Log data is incomplete or corrupted.
Cause: Data corruption during backup or deployment.
Fix: Reconstructing the lost data may be required.

4. Symptom: Service is not accessible at http://dozzle.netgrimoire.com.
Cause: Caddy configuration issues.
Fix: Review and correct caddy configuration files, then re-deploy the service.

5. Symptom: Monitoring fails to detect running containers.
Cause: Environment variable DOZZLE_MODE is missing or incorrect.
Fix: Set the DOZZLE_MODE environment variable to SWARM.

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | 3c650a78 | Initial documentation for dozzle stack. |
| 2026-04-30 | 39e7aaae | Updated deployment configuration to use resolved.yml. |
| 2026-04-30 | 395bc1e9 | Fixed Caddy reverse proxy label format. |
| 2026-04-29 | 39cd6448 | Corrected DOZZLE_MODE environment variable check. |
| 2026-04-29 | 083ae7fb | Added backup and restore instructions. |

---

## Notes
- Generated by Gremlin on 2026-04-30T19:55:32.480Z
- Source: swarm/dozzle.yaml