Troubleshooting
Server does not start: secret key
If startup reports that GIGA_AGENT_SECRET_KEY is missing, set it for shared servers. Local giga_agent dev can prepare a key automatically.
Chat opens but messages fail
Check that a connection to a model provider exists, a language model is created and selected, provider credentials are valid, the server uses /api, and required providers are configured.
RAG returns no results
Check user embeddings, Qdrant availability, collection indexing, and collection permissions.
Docker Compose starts but UI is unavailable
Run:
docker compose ps
The nginx entrypoint is usually http://localhost:8123.
A Yandex service fails to connect or dropped off
Check in order:
- The OAuth button is inactive —
YANDEX_OAUTH_CLIENT_IDandYANDEX_OAUTH_CLIENT_SECRETare not set (Mail needs its own pair). See Configuration. - An
invalid_scopeerror during authorization — the application scopes at oauth.yandex.ru do not match the requested ones: verify the application has the rights of the needed service, and that Mail has a separate application. - The card shows the re-authorization state — the stored token expired or was revoked: press Authorize on the Connected tab.
- The authorization window does not open — the browser blocked the popup; allow it for the server address.