Self-Hosting

Environment Variables

Configure your deployment with environment variables.

Required Variables

These environment variables must be set for the application to function:

OPENAI_API_KEYRequired

Your OpenAI API key for GPT model access

CLAUDE_API_KEYRequired

Your Anthropic API key for Claude model access

DATABASE_URLRequired

PostgreSQL connection string

Example: postgres://user:pass@localhost:5432/sophiaclaw

PORTDefault: 3000

Port to run the application on

LOG_LEVELDefault: info

Logging level: debug, info, warn, error

REDIS_URLDefault: redis://localhost:6379

Redis connection for caching and sessions

BULLETIN_ENABLEDDefault: true

Enable audit trail logging to Bulletin service

Never commit your .env file to version control. Add it to .gitignore immediately. Use strong, unique passwords in production.