Netgrimoire/Netgrimoire/Gremlin-Grimoire/Runbooks/Troubleshooting.md
2026-04-12 15:51:37 -05:00

1.8 KiB

title description published date tags editor dateCreated
Gremlin Troubleshooting Common Gremlin stack problems and fixes true 2026-04-12T00:00:00.000Z gremlin, troubleshooting, runbook markdown 2026-04-12T00:00:00.000Z

Gremlin Troubleshooting

n8n Won't Start / Permission Error

# 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.

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:

[webhook]
ALLOWED_HOST_LIST = *

Restart Forgejo. Required when OFFLINE_MODE = true.

Caddy Routes to Wrong Container IP

Ensure all Gremlin services include in labels:

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).