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