Environment Variables
Complete reference of all environment variables.
Environment Variables
Complete reference of all environment variables used by Optima Forge. Copy .env.example to .env and configure as needed.
Core
| Variable | Required | Default | Description |
|---|---|---|---|
NODE_ENV | No | development | Environment: development, production, test |
PORT | No | 3402 | API server port |
FORGE_API_SECRET | Yes | — | Master secret for signing API keys |
FORGE_ENCRYPTION_KEY | Yes | — | 32-byte encryption key for sensitive data |
Database
| Variable | Required | Default | Description |
|---|---|---|---|
TURSO_DATABASE_URL | Yes | — | Turso/libSQL database URL |
TURSO_AUTH_TOKEN | Yes | — | Turso authentication token |
REDIS_URL | Yes | redis://localhost:6379 | Redis connection URL |
NATS_URL | Yes | nats://localhost:4222 | NATS JetStream URL |
LLM Providers
| Variable | Required | Description |
|---|---|---|
OPENAI_API_KEY | No | OpenAI API key |
ANTHROPIC_API_KEY | No | Anthropic API key |
GOOGLE_AI_API_KEY | No | Google AI (Gemini) API key |
MISTRAL_API_KEY | No | Mistral API key |
GROQ_API_KEY | No | Groq API key |
TOGETHER_API_KEY | No | Together AI API key |
FIREWORKS_API_KEY | No | Fireworks AI API key |
DEEPSEEK_API_KEY | No | DeepSeek API key |
COHERE_API_KEY | No | Cohere API key |
Memory Services
| Variable | Required | Default | Description |
|---|---|---|---|
QDRANT_URL | No | http://localhost:6333 | Qdrant vector DB URL |
NEO4J_URI | No | bolt://localhost:7687 | Neo4j connection URI |
NEO4J_USER | No | neo4j | Neo4j username |
NEO4J_PASSWORD | No | — | Neo4j password |
Security
| Variable | Required | Default | Description |
|---|---|---|---|
SPICEDB_ENDPOINT | No | localhost:50051 | SpiceDB gRPC endpoint |
SPICEDB_TOKEN | No | — | SpiceDB pre-shared key |
OPA_URL | No | http://localhost:8181 | OPA policy engine URL |
Observability
| Variable | Required | Default | Description |
|---|---|---|---|
LANGFUSE_HOST | No | http://localhost:3000 | Langfuse host URL |
LANGFUSE_PUBLIC_KEY | No | — | Langfuse public key |
LANGFUSE_SECRET_KEY | No | — | Langfuse secret key |
Forge Connect
| Variable | Required | Default | Description |
|---|---|---|---|
FORGE_CONNECT_ENABLED | No | false | Enable Forge Connect |
FORGE_CONNECT_PROVIDER | No | pipedream | Connect provider adapter |
PIPEDREAM_CLIENT_ID | No | — | Pipedream OAuth client ID |
PIPEDREAM_CLIENT_SECRET | No | — | Pipedream OAuth client secret |
PIPEDREAM_PROJECT_ID | No | — | Pipedream project ID |
Forge Compute
| Variable | Required | Default | Description |
|---|---|---|---|
FLY_API_TOKEN | No | — | Fly.io API token for Compute machines |
FORGE_COMPUTE_BUDGET_CAP_MONTHLY | No | 100 | Monthly budget cap in USD |