---
title: beszel Stack
description: Beszel Service in NetGrimoire
published: true
date: 2026-05-05T18:41:28.673Z
tags: docker,swarm,beszel,netgrimoire
editor: markdown
dateCreated: 2026-05-05T18:41:28.673Z
---

# beszel

## Overview
The beszel Stack is a Docker Swarm configuration for the Beszel service in NetGrimoire. It consists of a single containerized service, beszel, which provides a critical functionality in our network infrastructure.

---

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

---

## Build & Configuration

### Prerequisites
This setup requires Docker Swarm and a basic understanding of environment variables.

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

### Environment Variables
```bash
generate: openssl rand -hex 32
```

### Deploy
```bash
cd services/swarm/stack/beszel
set -a && source .env && set +a
docker stack config --compose-file beszel-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml beszel
rm resolved.yml
docker stack services beszel
```

### First Run
No specific post-deploy steps are required.

---

## User Guide

### Accessing beszel
| Service | URL | Purpose |
- **beszel**: https://beszel.netgrimoire.com

### Primary Use Cases
 Beszel provides monitoring and reverse proxy functionality to the NetGrimoire environment.

### NetGrimoire Integrations
 Beszel connects to various services through environment variables, including kuma monitors and authentik imports.

---

## Operations

### Monitoring
```bash
docker stack services beszel
docker service logs beszel -f
```

### Backups
Critical data is stored on /DockerVol/beszel.

### Restore
```bash
./deploy.sh
```

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| Service not starting | Docker network issue | Check netgrimoire networks and ensure they are up-to-date. |
| Unauthorized access | Environment variable mismatch | Review environment variables and ensure correct values. |
| Monitoring issues | Kuma configuration error | Verify kuma monitors and adjust as necessary. |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-05-05 | 83fe560c | Initial setup and documentation. |
| 2026-05-01 | c3b0c0f5 | Various minor updates to configuration. |
| 2026-04-29 | 97b59dab | beszel Stack initialization. |

<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.>

---

## Notes
- Generated by Gremlin on 2026-05-05T18:41:28.673Z
- Source: swarm/beszel.yaml
- Review User Guide and Changelog sections