New Grimoire

Gremlin-Grimoire/Runbooks/Troubleshooting.md

@@ -0,0 +1,64 @@
+---
+title: Gremlin Troubleshooting
+description: Common Gremlin stack problems and fixes
+published: true
+date: 2026-04-12T00:00:00.000Z
+tags: gremlin, troubleshooting, runbook
+editor: markdown
+dateCreated: 2026-04-12T00:00:00.000Z
+---
+
+# Gremlin Troubleshooting
+
+## n8n Won't Start / Permission Error
+
+```bash
+# On docker4
+chown -R 1000:1000 /DockerVol/n8n
+docker service update --force gremlin_n8n
+```
+
+## Workflow Fails Silently on Ollama Call
+
+Model not pulled. Ollama returns model-not-found but n8n may not surface it clearly.
+
+```bash
+docker exec $(docker ps -qf name=gremlin_ollama) ollama list
+# If model missing:
+docker exec $(docker ps -qf name=gremlin_ollama) ollama pull llama3.2:3b
+docker exec $(docker ps -qf name=gremlin_ollama) ollama pull qwen2.5-coder:7b
+```
+
+## Forgejo Webhook Not Reaching n8n
+
+Add to Forgejo `app.ini`:
+```ini
+[webhook]
+ALLOWED_HOST_LIST = *
+```
+Restart Forgejo. Required when `OFFLINE_MODE = true`.
+
+## Caddy Routes to Wrong Container IP
+
+Ensure all Gremlin services include in labels:
+```yaml
+caddy_ingress_network: netgrimoire
+```
+
+Never use `{{upstreams PORT}}` — breaks during `docker stack config` preprocessing. Use `caddy.reverse_proxy: servicename:PORT`.
+
+## Audit Workflow Times Out
+
+Check `N8N_RUNNERS_TASK_TIMEOUT` is set to `3600` in n8n environment. Default timeout is too short for 67-file audit runs.
+
+## n8n Code Node Can't Access Env Vars
+
+Set `N8N_BLOCK_ENV_ACCESS_IN_NODE=false` in n8n environment.
+
+## Open WebUI Can't Connect to Qdrant
+
+Verify both services are on the `netgrimoire` overlay and pinned to `docker4`. Qdrant gRPC port is 6334, REST is 6333.
+
+## Audit Reports Not Committing to Forgejo
+
+Check write token is set in n8n credentials. The read and write tokens are separate — confirm the workflow is using the write token for commit operations (POST new files, PUT+SHA for updates).