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. |