> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uselumina.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration Reference

> Complete configuration reference for Lumina

Complete reference for Lumina configuration.

***

## Environment Variables

### Database

```bash theme={null}
DATABASE_URL=postgres://user:password@localhost:5432/lumina
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=lumina
POSTGRES_USER=lumina
POSTGRES_PASSWORD=secret
```

### Services

```bash theme={null}
INGESTION_PORT=9411
API_PORT=8081
REPLAY_PORT=8082
DASHBOARD_PORT=3000
```

### Retention

```bash theme={null}
TRACE_RETENTION_DAYS=7
DAILY_TRACE_LIMIT=50000
CLEANUP_SCHEDULE="0 0 * * *"
```

### LLM API Keys

```bash theme={null}
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
```

***

## Docker Compose

`docker-compose.yml`:

```yaml theme={null}
version: '3.8'

services:
  postgres:
    image: postgres:14
    environment:
      POSTGRES_PASSWORD: \${POSTGRES_PASSWORD}
    volumes:
      - postgres-data:/var/lib/postgresql/data

  ingestion:
    image: lumina/ingestion:latest
    ports:
      - "9411:9411"
    environment:
      DATABASE_URL: \${DATABASE_URL}
```

***

## Kubernetes

`values.yaml`:

```yaml theme={null}
ingestion:
  replicas: 3
  resources:
    requests:
      memory: "256Mi"
      cpu: "200m"

postgresql:
  enabled: true
  persistence:
    size: 50Gi
```
