Skip to main content

Configuration

What this page is for​

Configure backend runtime for ingestion, sessions, and publishing.

Prerequisites​

  • Installed backend and running Docker dependencies.

Steps​

  1. Create local env file.
cp .env.example .env
  1. Configure required values.
  • OPENAI_API_KEY
  • REDIS_HOST
  • QDRANT_URL
  1. Adjust optional operational values as needed.
  • PORT, THROTTLE_TTL, THROTTLE_LIMIT
  • SESSION_TTL
  • WEB_FETCH_TIMEOUT, WEB_MAX_CONTENT_LENGTH
  • MCP_USER_ID — user identity for MCP tool calls (default: mcp-server)
  1. Restart backend after edits.

Verify​

  • Startup has no env validation errors.
  • GET /api/health/readiness returns healthy checks.

Troubleshooting​

  • Large manual payload errors: review MANUAL_MAX_CONTENT_LENGTH.

Next steps​

  • /docs/getting-started/first-collection