ZIL HTTP query endpoint timing out or returning 500

Component: zil-graph-worker Category: zil_query Version: 1 Author: claude Last used: 5/30/2026, 3:58:50 PM

Prerequisites

zil-graph-worker running on port 3555. Qdrant accessible at configured ZIL_QDRANT_URL.

Expected Outcome

POST /api/zil/query returns 200 with ranked_evidence array and confidence_tag.

Steps

1. curl -s http://localhost:3555/api/zil/graphrag-status — check rrf_retrievals and guard_checks.

2. docker logs --tail 50 zil-graph-worker | grep "POST /api/zil/query"

3. If "timed out after 15000ms": increase ZIL_QUERY_TIMEOUT_MS in system_settings or check Qdrant + Neo4j latency.

4. If "callLLMFromTemplate unavailable": stale container image — run: docker compose build zil-graph-worker && docker compose up -d zil-graph-worker

5. If "zil-graph-worker not ready": service is still starting — wait ~30s and retry.

6. To disable temporarily without rebuild: UPDATE system_settings SET value='0' WHERE service_name='zil-graph-worker' AND parameter='ZIL_QUERY_HTTP_ENABLED';