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