Platform
ScaiWave ScaiGrid ScaiCore ScaiBot ScaiDrive ScaiKey Models Tools & Services
Solutions
Organisations Developers Internet Service Providers Managed Service Providers AI-in-a-Box
Resources
Support Documentation Blog Downloads
Company
About Research Careers Investment Opportunities Contact
Log in

Configuration

All configuration is environment-driven through pydantic-settings. backend/.env.example lists the backend variables; delivery and admin have no example file, so use the tables below.

Backend (backend/.env)#

Var Default Purpose
DATABASE_URL mysql+aiomysql://… MariaDB DSN.
REDIS_URL redis://localhost:6379/0 Cache + ARQ.
SECRET_KEY change-me-in-production JWT signing. Share with delivery.
ALGORITHM HS256 JWT alg. Share with delivery.
ACCESS_TOKEN_EXPIRE_MINUTES 30 JWT access TTL.
REFRESH_TOKEN_EXPIRE_DAYS 7 JWT refresh TTL.
CORS_ORIGINS [localhost:3000,…] Browser CORS allow-list.
API_KEY_PREFIX scai_ Prefix of issued keys.
S3_ENDPOINT_URL (empty) MinIO or other S3-compat.
S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY — S3 credentials.
S3_BUCKET_NAME scaicms-assets Bucket.
WEAVIATE_URL http://localhost:8080 Vector DB.
WEAVIATE_API_KEY — Auth for hosted Weaviate.
WEAVIATE_COLLECTION_NAME Content Content index.
WEAVIATE_DOC_COLLECTION_NAME DocPage Docs index.
SEARCH_HYBRID_ALPHA 0.7 0 = pure BM25; 1 = pure vector.
EMBEDDING_PROVIDER openai openai, external (any OpenAI-compatible endpoint) or none.
EMBEDDING_ENDPOINT_URL — Base URL for external, e.g. https://…/v1.
EMBEDDING_API_KEY — Key for the embedding endpoint; falls back to OPENAI_API_KEY.
EMBEDDING_MODEL text-embedding-3-small Model name sent to the endpoint.
EMBEDDING_DIMENSIONS 1536 Must match the model's output.
OPENAI_API_KEY — OpenAI key, used for openai embeddings and AI features.
RATE_LIMIT_ENABLED true Per-route-group request limits (RATE_LIMIT_*_REQUESTS / _WINDOW).
WORKER_MAX_JOBS 10 ARQ concurrency.
WORKER_JOB_TIMEOUT 300 Seconds before a job is killed.

Each service reads the .env in its own directory (backend/.env, delivery/.env) regardless of the directory it is started from.

If the embedding endpoint is unreachable, new pages are not indexed and search falls back to keyword-only matching; see Search index issues.

Delivery (delivery/.env)#

Var Default Purpose
DELIVERY_HOST, DELIVERY_PORT 0.0.0.0:8080 Listen address.
DELIVERY_DATABASE_URL shared with backend Read-only access.
DELIVERY_REDIS_URL shared with backend Cache + invalidations.
SECRET_KEY, ALGORITHM shared with backend Validates session cookies.
DELIVERY_DOCS_SESSION_COOKIE scaicms_docs_session Cookie name.
DELIVERY_DOCS_SESSION_MAX_AGE 604800 7 days.
DELIVERY_S3_* shared with backend Templates + media.

Admin (admin/.env)#

Var Default Purpose
VITE_API_URL proxied via vite Backend base URL.
Updated 2026-11-15 01:59:42 View source (.md) rev 4