From 91df1d68f50dbd445e6df99f50005d61e621dd42 Mon Sep 17 00:00:00 2001 From: traveler Date: Tue, 5 May 2026 13:42:30 -0500 Subject: [PATCH] docs(gremlin): update beszel --- Netgrimoire/Services/beszel/beszel.md | 77 ++++++++++----------------- 1 file changed, 28 insertions(+), 49 deletions(-) diff --git a/Netgrimoire/Services/beszel/beszel.md b/Netgrimoire/Services/beszel/beszel.md index 5259698..f67c7d8 100644 --- a/Netgrimoire/Services/beszel/beszel.md +++ b/Netgrimoire/Services/beszel/beszel.md @@ -1,24 +1,26 @@ --- title: beszel Stack -description: Beszel Service for NetGrimoire +description: Beszel Service in NetGrimoire published: true -date: 2026-04-29T19:52:18.919Z +date: 2026-05-05T18:41:28.673Z tags: docker,swarm,beszel,netgrimoire editor: markdown -dateCreated: 2026-04-29T19:52:18.919Z +dateCreated: 2026-05-05T18:41:28.673Z --- # 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. +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, beszel:8090 +- **Exposed via:** beszel.netgrimoire.com - **Homepage group:** Monitoring --- @@ -26,20 +28,17 @@ The beszel stack is a Docker Swarm configuration for the Beszel service in NetGr ## Build & Configuration ### 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 ```bash mkdir -p /DockerVol/beszel -chown -R user:group /DockerVol/beszel +chown -R beszel:beszel /DockerVol/beszel ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 -# generate: secret1 -# generate: secret2 -# ... more environment variables ... +generate: openssl rand -hex 32 ``` ### Deploy @@ -53,17 +52,7 @@ 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 -``` +No specific post-deploy steps are required. --- @@ -71,20 +60,13 @@ kuma --config kuma.yaml start ### Accessing beszel | Service | URL | Purpose | -|---------|-----|---------| -- **Beszel** | https://beszel.netgrimoire.com | Beszel Application | +- **beszel**: https://beszel.netgrimoire.com ### 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 -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 + Beszel connects to various services through environment variables, including kuma monitors and authentik imports. --- @@ -93,28 +75,25 @@ The beszel stack integrates with other NetGrimoire services, including: ### Monitoring ```bash docker stack services beszel -docker service logs -f beszel +docker service logs beszel -f ``` ### Backups -Critical data should be stored in a secure location, such as: - -- `/DockerVol/beszel/backups/` -- Regularly scheduled backups using `rsync` or similar tool +Critical data is stored on /DockerVol/beszel. ### 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. | +| 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. | --- @@ -122,15 +101,15 @@ cd services/swarm/stack/beszel | 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. | +| 2026-05-05 | 83fe560c | Initial setup and documentation. | +| 2026-05-01 | c3b0c0f5 | Various minor updates to configuration. | +| 2026-04-29 | 97b59dab | beszel Stack initialization. | + + --- ## 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 - Review User Guide and Changelog sections \ No newline at end of file