traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update beszel

Browse source
This commit is contained in:
traveler 2026-05-05 13:42:30 -05:00
parent 159a0af730
commit 91df1d68f5
1 changed files with 28 additions and 49 deletions
Download patch file Download diff file Expand all files Collapse all files

77
Netgrimoire/Services/beszel/beszel.md
View file

@ -1,24 +1,26 @@
--- ---
title: beszel Stack title: beszel Stack
description: Beszel Service for NetGrimoire description: Beszel Service in NetGrimoire
published: true published: true
date: 2026-04-29T19:52:18.919Z date: 2026-05-05T18:41:28.673Z
tags: docker,swarm,beszel,netgrimoire tags: docker,swarm,beszel,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-29T19:52:18.919Z dateCreated: 2026-05-05T18:41:28.673Z
--- ---
# beszel # beszel
## Overview ## 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. 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----| |---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** beszel.netgrimoire.com, beszel:8090 - **Exposed via:** beszel.netgrimoire.com
- **Homepage group:** Monitoring - **Homepage group:** Monitoring
--- ---
@ -26,20 +28,17 @@ The beszel stack is a Docker Swarm configuration for the Beszel service in NetGr
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
The beszel stack requires the Beszel image from Docker Hub and a working environment with the necessary tools. This setup requires Docker Swarm and a basic understanding of environment variables.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/beszel mkdir -p /DockerVol/beszel
chown -R user:group /DockerVol/beszel chown -R beszel:beszel /DockerVol/beszel
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 generate: openssl rand -hex 32
# generate: secret1
# generate: secret2
# ... more environment variables ...
``` ```
### Deploy ### Deploy
@ -53,17 +52,7 @@ docker stack services beszel
``` ```
### First Run ### First Run
Perform the following steps after deploying the beszel stack: No specific post-deploy steps are required.
```bash
# Initialize database
Beszel init
# Configure Caddy
caddy -config caddy.conf
# Start monitoring
kuma --config kuma.yaml start
```
--- ---
@ -71,20 +60,13 @@ kuma --config kuma.yaml start
### Accessing beszel ### Accessing beszel
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **beszel**: https://beszel.netgrimoire.com
- **Beszel** | https://beszel.netgrimoire.com | Beszel Application |
### Primary Use Cases ### Primary Use Cases
Use the Beszel application for monitoring and management of NetGrimoire services. Beszel provides monitoring and reverse proxy functionality to the NetGrimoire environment.
### NetGrimoire Integrations ### NetGrimoire Integrations
The beszel stack integrates with other NetGrimoire services, including: Beszel connects to various services through environment variables, including kuma monitors and authentik imports.
* `monitor.name`: Beszel Monitor URL
* `monitor.url`: Beszel Monitor URL
* `caddy`: beszel.netgrimoire.com
* `caddy.import_1`: crowdsec
* `caddy.import_2`: authentik
--- ---
@ -93,28 +75,25 @@ The beszel stack integrates with other NetGrimoire services, including:
### Monitoring ### Monitoring
```bash ```bash
docker stack services beszel docker stack services beszel
docker service logs -f beszel docker service logs beszel -f
``` ```
### Backups ### Backups
Critical data should be stored in a secure location, such as: Critical data is stored on /DockerVol/beszel.
- `/DockerVol/beszel/backups/`
- Regularly scheduled backups using `rsync` or similar tool
### Restore ### Restore
```bash ```bash
cd services/swarm/stack/beszel
./deploy.sh ./deploy.sh
``` ```
--- ---
## Common Failures ## Common Failures
| Failure | Symptoms | Cause | Fix | | Symptom | Cause | Fix |
|--------|---------|------|-----| |---------|-------|-----|
| Beszel App Down | Beszel app not responding. | No connection to Caddy. | Restart Caddy and Beszel services. | | Service not starting | Docker network issue | Check netgrimoire networks and ensure they are up-to-date. |
| 404 Not Found | Caddy cannot resolve domain. | Incorrect DNS settings in Caddy configuration. | Update DNS settings in Caddy configuration. | | Unauthorized access | Environment variable mismatch | Review environment variables and ensure correct values. |
| Monitoring issues | Kuma configuration error | Verify kuma monitors and adjust as necessary. |
--- ---
@ -122,15 +101,15 @@ cd services/swarm/stack/beszel
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-29 | 97b59dab | Updated Docker Swarm configuration to use swarm/beszel.yaml | | 2026-05-05 | 83fe560c | Initial setup and documentation. |
| 2026-04-29 | 4f156d9f | Added logging to Beszel application for debugging purposes. | | 2026-05-01 | c3b0c0f5 | Various minor updates to configuration. |
| 2026-04-29 | fcd439af | Fixed security vulnerability in Caddy configuration. | | 2026-04-29 | 97b59dab | beszel Stack initialization. |
| 2026-04-29 | 7f19d45e | Updated monitoring scripts for Beszel service. |
| 2026-04-29 | 06882cc5 | Improved performance of Beszel application by optimizing database queries. | <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 ## Notes
- Generated by Gremlin on 2026-04-29T19:52:18.919Z - Generated by Gremlin on 2026-05-05T18:41:28.673Z
- Source: swarm/beszel.yaml - Source: swarm/beszel.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections