docs(gremlin): create gremlin-stack

Netgrimoire/Services/gremlin-stack/gremlin-stack.md

@@ -0,0 +1,148 @@
+---
+title: gremlin-stack Stack
+description: A Docker Swarm-based NetGrimoire stack for services including Ollama, Open WebUI, Qdrant, and N8N.
+published: true
+date: 2026-04-15T23:46:37.618Z
+tags: docker, swarm, gremlin-stack, netgrimoire
+editor: markdown
+dateCreated: 2026-04-15T23:46:37.618Z
+---
+
+# gremlin-stack
+
+## Overview
+The gremlin-stack is a Docker Swarm-based NetGrimoire stack that provides services including Ollama, Open WebUI, Qdrant, and N8N.
+
+---
+
+## Architecture
+| Service | Image | Port | Role |
+|----------|-------|------|-------|
+- **Host:** docker4
+- **Network:** netgrimoire
+- **Exposed via:** ai.netgrimoire.com, n8n.netgrimoire.com, qdrant.netgrimoire.com
+- **Homepage group:** homepage.group
+
+---
+
+## Build & Configuration
+
+### Prerequisites
+No specific prerequisites for this stack.
+
+### Volume Setup
+```bash
+mkdir -p /DockerVol/ollama
+chown -R o-rwx /DockerVol/ollama
+```
+
+```bash
+mkdir -p /DockerVol/open-webui
+chown -R o-rwx /DockerVol/open-webui
+```
+
+```bash
+mkdir -p /DockerVol/qdrant
+chown -R o-rwx /DockerVol/qdrant
+```
+
+```bash
+mkdir -p /DockerVol/n8n
+chown -R o-rwx /DockerVol/n8n
+```
+
+### Environment Variables
+| Variable | Description |
+|----------|-------------|
+# generate: openssl rand -hex 32
+WEBUI_SECRET_KEY=<generated secret key>
+N8N_USER=<generated user>
+N8N_PASSWORD=<generated password>
+NTFY_URL=<generated url>
+FORGEJO_URL=<generated url>
+FORGEJO_TOKEN=<generated token>
+FORGEJO_DOCS_OWNER=<generated owner>
+FORGEJO_DOCS_REPO=<generated repo>
+FORGEJO_WRITE_TOKEN=<generated write token>
+OLLAMA_MODEL_GENERAL=<generated model general>
+OLLAMA_MODEL_CODE=<generated code>
+
+---
+
+## Deploy
+```bash
+cd services/swarm/stack/gremlin-stack
+set -a && source .env && set +a
+docker stack config --compose-file gremlin-stack.stack.yml > resolved.yml
+docker stack deploy --compose-file resolved.yml gremlin-stack
+rm resolved.yml
+docker stack services gremlin-stack
+```
+
+### First Run
+Post-deploy steps specific to these services.
+
+---
+
+## User Guide
+
+### Accessing gremlin-stack
+| Service | URL | Purpose |
+|---------|-----|---------|
+Exposing via Caddy domains from labels:
+- ai.netgrimoire.com
+- n8n.netgrimoire.com
+- qdrant.netgrimoire.com
+Open WebUI: https://ai.netgrimoire.com
+
+### Primary Use Cases
+How to actually use this in NetGrimoire.
+
+### NetGrimoire Integrations
+Which other services this connects to — derive from env vars and labels.
+
+---
+
+## Operations
+
+### Monitoring
+<kuma monitors from kuma.* labels>
+```bash
+docker stack services gremlin-stack
+<docker service logs commands>
+```
+
+### Backups
+Critical vs reconstructable /DockerVol/ paths.
+
+### Restore
+```bash
+cd services/swarm/stack/gremlin-stack
+./deploy.sh
+```
+
+---
+
+## Common Failures
+5 specific failure modes with symptom, cause, fix.
+
+---
+
+## Changelog
+
+| Date | Commit | Summary |
+|------|--------|---------|
+2026-04-15 | 9ed423bc | Initial documentation for gremlin-stack stack.
+2026-04-15 | e544cddd | 
+2026-04-15 | 942855e4 | 
+2026-04-14 | 13d50426 | 
+2026-04-03 | e3955c7f | 
+| 954c02a1 | 
+| 94292307 | 
+| 0d2ae10e | 
+| 690a53f8 | 
+| 065c95f0 | 
+
+Generated by Gremlin on 2026-04-15T23:46:37.618Z
+Source: swarm/stack/Gremlin/gremlin-stack.yml
+Review User Guide and Changelog sections