Troubleshooting

The snags you are most likely to hit while following the quickstart. The product troubleshooting reference has the complete list.

Starting the stack

Symptom	Likely cause	What to do
The stack does not boot	OPENAI_API_KEY missing in .env	cp .env.example .env and set the key
Login redirects to :3000 or "invalid redirect"	Keycloak still holds an old realm	Re-import the realm, see the product authentication guide
LLM calls fail with 401 from the gateway	Wrong LITELLM_VIRTUAL_KEY, or seed did not run	docker compose logs local-seed

First workflow run

Symptom	Likely cause	What to do
Health is UP, but every agent run fails	Ollama not running or model not pulled	ollama list must show qwen3.6:27b
Runs fail after setting OLLAMA_BASE_URL=http://localhost:11434	.env applies inside the container	Remove the override or use an address the container can reach
A job fails to start its container	Job image not pulled	docker pull eclipse-temurin:25-jre

Everything else

Policy blocks, 502 errors and "run state lost" are covered in the full troubleshooting reference.