traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Netgrimoire/Netgrimoire/Watch-Grimoire/Monitoring/DIUN.md
traveler e55070398b move
2026-04-12 15:51:37 -05:00

3.5 KiB
Raw Blame History

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

mkdir -p /DockerVol/diun
chown -R 1964:1964 /DockerVol/diun

Environment Variables

# 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

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>

docker stack services diun
docker service logs diun -f

Backups

Critical data is stored on /DockerVol/diun.

Restore

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