Troubleshooting

If something isn’t working as expected, here are a few quick things to check:

1. Check Docker logs If running with Docker, you can view logs with:

bashCopyEditdocker compose logs -f

Look for any obvious errors like failed ports, missing environment variables, or dependency issues.

2. Verify .env settings Make sure all required values are correctly defined and saved in your .env file. Restart your services after any change.

3. Embedding not working?

  • Check that your embedding provider is properly set up

  • Ensure your vector database (Chroma or Pinecone) is running

  • Uploaded files must be parsable text formats (PDF, DOCX, TXT, etc.)

4. LLM not responding?

  • If using local models, confirm the server is running and accessible

  • For hosted models, confirm the provider is reachable from your machine

Still stuck? Try resetting your workspace or reviewing console errors for additional details.

PreviousContributingNextResetting Xio

Last updated