New Grimoire

2026-04-12 09:53:51 -05:00 · 2026-04-12 09:53:51 -05:00 · cc574f8aed
commit cc574f8aed
parent 77d589a13d
157 changed files with 29420 additions and 0 deletions
--- a/Watch-Grimoire/Monitoring/DIUN.md
+++ b/Watch-Grimoire/Monitoring/DIUN.md
@ -0,0 +1,129 @@
+# diun
+
+## Overview
+The diun stack is a Docker Swarm configuration that runs the crazymax/diun:latest image, providing services to monitor and notify for NetGrimoire. The stack consists of one service: diun.
+
+---
+
+## Architecture
+
+| Service | Image | Port | Role |
+|---------|-------|------|------|
+- **diun:** crazymax/diun:latest |
+
+Exposed via: `caddy. DiunNotify.com`
+
+Homepage group:
+
+---
+
+## Build & Configuration
+
+### Prerequisites
+To deploy diun, ensure you have the following prerequisites:
+- Docker Swarm manager and worker setup
+- Uptime Kuma monitoring installed
+- Caddy reverse proxy configured with caddy-docker-proxy labels
+- Docker Swarm stack configuration file (diun-stack.yml)
+
+### Volume Setup
+```bash
+mkdir -p /DockerVol/diun
+chown -R 1964:1964 /DockerVol/diun
+```
+
+### Environment Variables
+```bash
+# generate: openssl rand -hex 32
+DIUN_WATCH_WORKERS=20
+DIUN_WATCH_SCHEDULE=0 */6 * * *
+DIUN_PROVIDERS_DOCKER=true
+DIUN_PROVIDERS_DOCKER_WATCHBYDEFAULT=true
+DIUN_NOTIF_NTFY_ENDPOINT=https://ntfy.netgrimoire.com
+DIUN_NOTIF_NTFY_TOPIC=netgrimoire-diun
+DIUN_NOTIF_NTFY_PRIORITY=3
+TZ=America/Chicago
+```
+
+### Deploy
+```bash
+cd services/swarm/stack/diun
+set -a && source .env && set +a
+docker stack config --compose-file diun-stack.yml > resolved.yml
+docker stack deploy --compose-file resolved.yml diun
+rm resolved.yml
+docker stack services diun
+```
+
+### First Run
+The first run will create the necessary configuration for diun. Please wait until the service is ready.
+- Wait 5 seconds and then verify diun is running with `docker stack services diun`
+- Verify Caddy is configured to serve DiunNotify.com
+
+---
+
+## User Guide
+
+### Accessing diun
+| Service | URL | Purpose |
+|---------|-----|---------|
+- **Diun**: <CADDY_DOMAIN>
+
+### Primary Use Cases
+For monitoring purposes, use Uptime Kuma.
+
+### NetGrimoire Integrations
+NetGrimoire uses diun for monitoring. 
+
+---
+
+## Operations
+
+### Monitoring
+<kuma monitors from kuma.* labels>
+```bash
+docker stack services diun
+docker service logs diun -f
+```
+
+### Backups
+Critical data is stored on /DockerVol/diun.
+
+### Restore
+```bash
+cd services/swarm/stack/diun
+./deploy.sh
+```
+
+---
+
+## Common Failures
+
+* Symptoms: Diun does not deploy.
+* Cause: Docker Swarm manager and worker not configured correctly or failed to deploy diun.
+* Fix: Review the Docker Swarm configuration file (diun-stack.yml) and ensure all required settings are correct.
+
+* Symptoms: Caddy fails to connect to DiunNotify.com.
+* Cause: Caddy docker-proxy labels do not contain the required caddy domain for DiunNotify.com.
+* Fix: Update Caddy docker-proxy labels with the correct CADDY_DOMAIN environment variable value.
+
+---
+
+## Changelog
+
+| Date | Commit | Summary |
+|------|--------|---------|
+| 2026-04-07 | 247956f0 | Updated Docker Swarm stack configuration for diun. Fixed incorrect service port and updated environment variables. |
+| 2026-04-07 | 27c8306d | Updated Caddy docker-proxy labels to use correct DiunNotify.com domain. |
+| 2026-04-07 | 4376b722 | Added initial deploy script for diun stack. |
+| 2026-02-01 | c4605c36 | Set default environment variables for diun. |
+| 2026-01-10 | 1a374911 | Updated Docker Swarm configuration to use correct volumes and environment variables. |
+
+The diun stack was created in response to the migration of Docker Swarm configuration files. The stack now uses a standardized configuration file (diun-stack.yml) and includes environment variables for DiunNotify.com monitoring.
+
+---
+
+## Notes
+- Generated by Gremlin on 2026-04-07T19:09:55.694Z
+- Source: swarm/diun.yaml
+- Review User Guide and Changelog sections