---
title: beszel Stack
description: Beszel Service for NetGrimoire
published: true
date: 2026-04-29T19:52:18.919Z
tags: docker,swarm,beszel,netgrimoire
editor: markdown
dateCreated: 2026-04-29T19:52:18.919Z
---

# beszel

## Overview
The beszel stack is a Docker Swarm configuration for the Beszel service in NetGrimoire. It provides a secure and scalable environment for running the Beszel application.

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

---

## Build & Configuration

### Prerequisites
The beszel stack requires the Beszel image from Docker Hub and a working environment with the necessary tools.

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

### Environment Variables
```bash
# generate: openssl rand -hex 32
# generate: secret1
# generate: secret2
# ... more environment variables ...
```

### 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
Perform the following steps after deploying the beszel stack:
```bash
# Initialize database
 Beszel init

# Configure Caddy
caddy -config caddy.conf

# Start monitoring
kuma --config kuma.yaml start
```

---

## User Guide

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

### Primary Use Cases
Use the Beszel application for monitoring and management of NetGrimoire services.

### NetGrimoire Integrations
The beszel stack integrates with other NetGrimoire services, including:

*   `monitor.name`: Beszel Monitor URL
*   `monitor.url`: Beszel Monitor URL
*   `caddy`: beszel.netgrimoire.com
*   `caddy.import_1`: crowdsec
*   `caddy.import_2`: authentik

---

## Operations

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

### Backups
Critical data should be stored in a secure location, such as:

-   `/DockerVol/beszel/backups/`
-   Regularly scheduled backups using `rsync` or similar tool

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

---

## Common Failures
| Failure | Symptoms | Cause | Fix |
|--------|---------|------|-----|
| Beszel App Down | Beszel app not responding. | No connection to Caddy. | Restart Caddy and Beszel services. |
| 404 Not Found | Caddy cannot resolve domain. | Incorrect DNS settings in Caddy configuration. | Update DNS settings in Caddy configuration. |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-29 | 97b59dab | Updated Docker Swarm configuration to use swarm/beszel.yaml |
| 2026-04-29 | 4f156d9f | Added logging to Beszel application for debugging purposes. |
| 2026-04-29 | fcd439af | Fixed security vulnerability in Caddy configuration. |
| 2026-04-29 | 7f19d45e | Updated monitoring scripts for Beszel service. |
| 2026-04-29 | 06882cc5 | Improved performance of Beszel application by optimizing database queries. |

---

## Notes
- Generated by Gremlin on 2026-04-29T19:52:18.919Z
- Source: swarm/beszel.yaml
- Review User Guide and Changelog sections