Configuration Reference
OpenCodeHub is configured exclusively via environment variables.
Core
| Variable |
Description |
Required |
Default |
SITE_URL |
Public URL of the instance |
Yes |
http://localhost:3000 |
PORT |
Port to listen on |
No |
3000 |
NODE_ENV |
development or production |
No |
development |
Security (Critical)
| Variable |
Description |
Generate With |
JWT_SECRET |
Signs auth tokens |
openssl rand -hex 32 |
SESSION_SECRET |
Signs session cookies |
openssl rand -hex 32 |
INTERNAL_HOOK_SECRET |
Secures git hooks |
openssl rand -hex 32 |
Database
| Variable |
Description |
Example |
DATABASE_DRIVER |
postgres, mysql, sqlite, libsql |
postgres |
DATABASE_URL |
Connection string |
postgresql://user:pass@host:5432/db |
DATABASE_AUTH_TOKEN |
Auth token (Turso/LibSQL only) |
|
Storage
| Variable |
Description |
Default |
STORAGE_TYPE |
local, s3, gdrive, azure |
local |
STORAGE_PATH |
Path for local storage |
./data |
STORAGE_BUCKET |
Bucket name (S3/GCP) |
|
STORAGE_REGION |
AWS Region |
us-east-1 |
STORAGE_ENDPOINT |
Custom S3 endpoint |
|
S3_ACCESS_KEY |
AWS Access Key |
|
S3_SECRET_KEY |
AWS Secret Key |
|
AI Review
| Variable |
Description |
AI_PROVIDER |
openai or anthropic |
OPENAI_API_KEY |
OpenAI API Key |
ANTHROPIC_API_KEY |
Anthropic API Key |
Email (SMTP)
| Variable |
Description |
SMTP_HOST |
Hostname (e.g. smtp.gmail.com) |
SMTP_PORT |
Port (e.g. 587) |
SMTP_USER |
Username |
SMTP_PASSWORD |
Password |
SMTP_FROM |
From address |