Skip to content
Gittensory
Self-hosting

Troubleshooting

Start with readiness and logs, then isolate webhook, queue, AI, REES, RAG, or write-suppression problems.

First checks

docker compose ps
docker compose logs --tail=200 gittensory
curl http://localhost:8787/ready
curl http://localhost:8787/metrics
bash

No review appears

Webhook
Check GitHub App deliveries and confirm /v1/github/webhook receives 2xx responses.
Allowlist
Confirm the repo is in GITTENSORY_REVIEW_REPOS for per-PR features.
Write mode
SELFHOST_DEPLOYMENT_MODE=dry-run or disabled suppresses writes even when review computes.
Policy
gate.aiReview.mode=off or commentMode=off can make AI/comment output intentionally quiet.

AI summary unavailable

  • Confirm AI_PROVIDER is set and supported.
  • Confirm the provider key or local endpoint works from inside the container.
  • Set the matching provider model env, such as ANTHROPIC_AI_MODEL, OPENAI_COMPATIBLE_AI_MODEL, OLLAMA_AI_MODEL, CLAUDE_AI_MODEL, or CODEX_AI_MODEL.
  • Increase the matching provider timeout env, such as CLAUDE_AI_TIMEOUT_MS or CODEX_AI_TIMEOUT_MS, for large subscription-CLI reviews.
  • For CLI providers, confirm the CLI binary and credential path are available.

REES is silent

A no-finding REES response can be intentionally invisible. For failures, search logs forreview_context_fetch_failed with contextType set to enrichment.

review_context_fetch_failed
rees_analyzer_config_invalid

Check REES enrichment for enablement and REES analyzer reference for analyzer names, network calls, and token requirements.

RAG returns no context

  • Confirm GITTENSORY_REVIEW_RAG=true and repo activation.
  • Confirm Qdrant or the vector backend is reachable from the app container.
  • Confirm the embedding endpoint and model are running.
  • Confirm the repo has been indexed after enabling the feature.

Queue stuck or dead jobs

Watch pending, processed, failed, and dead metrics. A high pending count can be webhook replay or maintenance work; dead jobs need direct investigation.

curl http://localhost:8787/metrics | grep gittensory_queue
docker compose logs gittensory | grep selfhost_job_dead
bash

Readiness fails

DB
Check DATABASE_URL or DATABASE_PATH, volume permissions, Postgres reachability, and migrations.
Migrations
Read startup logs for migration errors before recreating volumes.
Dependencies
If Qdrant or Postgres profiles are enabled, confirm those services are healthy first.
← PreviousSecurityNext →How reviews work