Search index issues
"I wrote a page and search doesn't find it"#
Index writes are async. Expect 1–3 seconds of lag, longer if the worker is backed up.
- Worker running?
ps aux | grep scaicms-worker. - Queue size: in the admin UI go to Queue Monitor.
- Force a reindex of the namespace:bash
1python -m scaicms.cli docs-index reindex --namespace <slug>
"Nothing new gets indexed at all"#
Indexing a page needs an embedding from the configured provider
(EMBEDDING_PROVIDER, EMBEDDING_ENDPOINT_URL, EMBEDDING_MODEL; see
Configuration). If the provider is
unreachable, every write fails to index and the page is left out of search.
A reindex shows it plainly:
1 2 | |
Check the provider directly, then fix the configuration and reindex:
1 | |
Queries degrade more gently than indexing: when a query embedding cannot be produced, search falls back to keyword-only (BM25) matching over what is already indexed, instead of failing.
"Search returns old text"#
The chunker re-chunks on every page write — old chunks are deleted before
new ones are inserted. If you see old text, you're probably hitting a cache.
Try ?_nocache=1 on the search URL to bypass.
"I think the index drifted"#
1 2 | |
If counts disagree with the DB, run a full reindex. As a last resort:
1 2 | |