​
Overview

camelAI uses environment variables to configure various aspects of the application. These variables are typically set in a .env.docker file in the project root. A template file is provided in the repository.

​
Required Variables

​
Django Settings

# Django secret key for cryptographic signing
DJANGO_SECRET_KEY=change_this_to_a_secure_key_in_production

# Hostname and site URL
HOSTNAME=localhost
SITE_URL=http://localhost:8000

​
Database Configuration

# PostgreSQL password
POSTGRES_PASSWORD=secure_password
DB_PASSWORD=${POSTGRES_PASSWORD}

​
Email Configuration

# Set to True if SMTP is not setup
DISABLE_EMAIL=True

​
AI Provider Settings

# Set to True if using Bedrock only
USE_BEDROCK_ONLY=True

# Set to False if you don't want to use the prompt cache
USE_PROMPT_CACHE=True

# OpenAI and Anthropic API keys (if not using Bedrock)
# OPENAI_API_KEY=your_openai_api_key
# ANTHROPIC_API_KEY=your_anthropic_api_key

​
AWS Configuration

# AWS credentials for Bedrock
# Note: The AWS user must have the AmazonBedrockFullAccess IAM policy
AWS_ACCESS_KEY_ID=your_access_key_id
AWS_SECRET_ACCESS_KEY=your_secret_access_key
AWS_REGION=your_region

​
Example Configuration

Here’s a complete example of a .env.docker file:

# Django Settings
DJANGO_SECRET_KEY=change_this_to_a_secure_key_in_production
HOSTNAME=localhost
SITE_URL=http://localhost:8000

# Database Configuration
POSTGRES_PASSWORD=secure_password
DB_PASSWORD=${POSTGRES_PASSWORD}

# Email Configuration
DISABLE_EMAIL=True

# AI Provider Settings
USE_BEDROCK_ONLY=True
USE_PROMPT_CACHE=True

# AWS Configuration
AWS_ACCESS_KEY_ID=your_access_key_id
AWS_SECRET_ACCESS_KEY=your_secret_access_key
AWS_REGION=your_region

​
Security Best Practices

  1. Never commit the .env.docker file to version control
  2. Use strong, unique passwords for all credentials
  3. Keep your secret keys secure and rotate them regularly
  4. Use HTTPS in production

​
Updating Variables

After updating environment variables:

  1. Stop the services:

    docker compose down

  2. Rebuild and restart:

    docker compose -f docker-compose.prod.yml up -d --build

​
Next Steps

After configuring your environment variables:

  1. Start the Services
  2. Create a Superuser
  3. Begin Using camelAI