Skip to content

troubleshooting.md

Latest commit

 

History

History
43 lines (30 loc) · 1.99 KB

troubleshooting.md

File metadata and controls

43 lines (30 loc) · 1.99 KB
Raw

Troubleshooting (SIE-focused)

Short FAQ for gallery readers. Full tables and recovery steps: project troubleshooting (especially the SIE section) and sie-setup.md.

"sie": "disabled" on /health

SIE_ENABLED is false or unset (default). Set SIE_ENABLED=true, set SIE_ENDPOINT, reload the server.

"sie": "unreachable" (or preflight fails)

  • Wrong SIE_ENDPOINT (typo, http vs https, missing port)
  • Gateway auth: set SIE_API_KEY and use Authorization: Bearer … on /healthz
  • Local Docker: SIE not running, still warming up, or server-in-Docker needs host.docker.internal:8720
  • Encode still returning 503 during model load — wait until encode returns 200

Sweep with provider: sie fails immediately

SIE guard runs preflight. Fix health/SIE_ENABLED first, then re-run. Confirm indexes for your storage backend (vector_index_1024 + text index on Mongo for typical SIE configs — see project MongoDB setup).

./start-services.sh did not bring up SIE

Expected. Start a remote gateway or follow self-hosted Docker in sie-setup.md.

Dashboard up but no SIE experiments

Use a SIE config such as configs/mongodb/example-sie.yaml, not a Voyage-only or local-only example.

Still stuck?

  1. sie-setup.md — known issues, warm-up, Aim UI
  2. troubleshooting.md — indexes, Docker, storage
  3. Open an issue on neomatrix369/rag-params-finder