Platform
ScaiWave ScaiGrid ScaiCore ScaiBot ScaiDrive ScaiKey Modellen Tools & Services
Oplossingen
Organisaties Ontwikkelaars Internet Service Providers Managed Service Providers AI-in-a-Box
Kenniscentrum
Ondersteuning Documentation Blog Downloads
Bedrijf
Over ons Onderzoek Vacatures Investeren Contact
Inloggen

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.

  1. Worker running? ps aux | grep scaicms-worker.
  2. Queue size: in the admin UI go to Queue Monitor.
  3. Force a reindex of the namespace:
    bash
    1
    python -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:

bash
1
2
python -m scaicms.cli docs-index reindex --namespace <slug>
# Reindex complete: {'indexed': 0, 'failed': 22, 'chunks': 0}

Check the provider directly, then fix the configuration and reindex:

bash
1
curl -sS "$EMBEDDING_ENDPOINT_URL/models" -H "Authorization: Bearer $EMBEDDING_API_KEY"

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"#

bash
1
2
python -m scaicms.cli.index_management check       # content
python -m scaicms.cli docs-index status            # docs

If counts disagree with the DB, run a full reindex. As a last resort:

bash
1
2
python -m scaicms.cli docs-index reset             # destructive!
python -m scaicms.cli docs-index reindex
Updated 2026-11-15 01:58:03 View source (.md) rev 3