Environment Configuration
DAIV provides a large number of environment variables that can be used to configure DAIV behavior. This page lists all supported environment variables.
Variables marked with:
- are sensitive (such as API keys, passwords, and tokens) and should be declared using Docker secrets or a secure credential manager.
- are required and should be declared.
Core
General
| Variable | Description | Default | Example |
|---|---|---|---|
DJANGO_DEBUG |
Toggle Django debug mode | False |
True |
DJANGO_SECRET_KEY |
Secret key for Django | (none) | super-secret-key |
DJANGO_ALLOWED_HOSTS |
Comma-separated list of allowed hosts | * |
example.com,localhost |
Danger
Do not turn on DJANGO_DEBUG in production. It will expose sensitive information and break the security of the application.
Info
The DJANGO_ALLOWED_HOSTS variable is used to specify the hosts that are allowed to access the application. Make sure to include the host where the application is running to increase security.
Uvicorn
| Variable | Description | Default | Example |
|---|---|---|---|
UVICORN_HOST |
Host to bind the Uvicorn server | 0.0.0.0 |
0.0.0.0 |
UVICORN_PORT |
Port to bind the Uvicorn server | 8000 |
8000 |
Database
| Variable | Description | Default | Example |
|---|---|---|---|
DB_NAME |
Database name | (none) | daiv |
DB_USER |
Database user | (none) | daiv_admin |
DB_PASSWORD |
Database password | (none) | |
DB_HOST |
Database host | localhost |
db |
DB_PORT |
Database port | 5432 |
5432 |
DB_SSLMODE |
PostgreSQL SSL mode | require |
prefer |
DB_POOL_MAX_SIZE |
Maximum size of a connection pool | 15 |
30 |
Redis
| Variable | Description | Default | Example |
|---|---|---|---|
DJANGO_REDIS_URL |
Redis connection URL | (none) | redis://redis:6379/0 |
Celery / Broker
| Variable | Description | Default | Example |
|---|---|---|---|
DJANGO_BROKER_URL |
Celery broker URL | memory:/// |
redis://redis:6379/0 |
DJANGO_BROKER_USE_SSL |
Use SSL for broker connection | False |
True |
CELERY_LOGLEVEL |
Celery log level | INFO |
DEBUG |
CELERY_CONCURRENCY |
Number of Celery workers | 2 |
4 |
Note
The CELERY_CONCURRENCY variable is used to specify the number of Celery workers to use. This is useful for scaling the application. The default value is 2 which is suitable for most use cases.
Sentry
| Variable | Description | Default | Example |
|---|---|---|---|
SENTRY_DSN |
Sentry DSN | (none) | |
SENTRY_DEBUG |
Enable Sentry debug mode | False |
True |
SENTRY_ENABLE_TRACING |
Enable Sentry tracing | False |
True |
NODE_HOSTNAME |
Node hostname for Sentry | (none) | |
SERVICE_NAME |
Service name for Sentry | (none) |
Note
NODE_HOSTNAME and SERVICE_NAME are used to identify the node and service that is reporting the error.
Logging
| Variable | Description | Default | Example |
|---|---|---|---|
DJANGO_LOGGING_LEVEL |
Django logging level | INFO |
DEBUG |
Monitoring (LangSmith)
| Variable | Description | Default | Example |
|---|---|---|---|
LANGSMITH_TRACING |
Enable LangSmith tracing (alternative) | False |
true |
LANGSMITH_PROJECT |
LangSmith project name (alternative) | default |
daiv-production |
LANGSMITH_API_KEY |
LangSmith API key (alternative) | (none) | lsv2_pt_... |
LANGSMITH_API_KEY_FILE |
Path to LangSmith API key file | (none) | /run/secrets/langsmith_api_key |
LANGSMITH_ENDPOINT |
LangSmith API endpoint | https://api.smith.langchain.com |
https://eu.api.smith.langchain.com |
Note
LangSmith provides comprehensive monitoring and observability for AI agents. For detailed setup instructions, see Monitoring Configuration.
Sandbox (client-side)
| Variable | Description | Default | Example |
|---|---|---|---|
DAIV_SANDBOX_URL |
URL of the sandbox service | http://sandbox:8000 |
http://sandbox:8000 |
DAIV_SANDBOX_TIMEOUT |
Timeout for sandbox requests in seconds | 600 |
600 |
DAIV_SANDBOX_API_KEY |
API key for sandbox requests | (none) | random-api-key |
Info
Check the daiv-sandbox repository for server-side configuration of the sandbox service.
Other
| Variable | Description | Default | Example |
|---|---|---|---|
DAIV_EXTERNAL_URL |
External URL of the application. | https://app:8000 |
https://daiv.example.com |
Note
The DAIV_EXTERNAL_URL variable is used to define webhooks on Git platform. Make sure that the URL is accessible from the Git platform.
Codebase
General
| Variable | Description | Default | Example |
|---|---|---|---|
CODEBASE_CLIENT |
Client to use for codebase operations | gitlab |
gitlab or github |
Note
Set CODEBASE_CLIENT to either gitlab or github depending on which platform you want to use. Only one platform can be active at a time.
GitLab Integration
| Variable | Description | Default | Example |
|---|---|---|---|
CODEBASE_GITLAB_URL |
URL of the GitLab instance | (none) | https://gitlab.com |
CODEBASE_GITLAB_AUTH_TOKEN |
Authentication token for GitLab | (none) | glpat-xyz |
CODEBASE_GITLAB_WEBHOOK_SECRET |
Secret token for GitLab webhook validation | (none) | random-webhook-secret |
Note
The CODEBASE_GITLAB_AUTH_TOKEN is used to authenticate with the GitLab instance using a personal access token with the api scope.
GitHub Integration
| Variable | Description | Default | Example |
|---|---|---|---|
CODEBASE_GITHUB_URL |
URL of the GitHub instance | (none) | https://github.com |
CODEBASE_GITHUB_APP_ID |
GitHub App ID | (none) | 123456 |
CODEBASE_GITHUB_INSTALLATION_ID |
GitHub App Installation ID | (none) | 789012 |
CODEBASE_GITHUB_PRIVATE_KEY |
GitHub App private key (PEM format) | (none) | |
CODEBASE_GITHUB_WEBHOOK_SECRET |
Secret token for GitHub webhook validation | (none) | random-webhook-secret |
Note
GitHub uses GitHub App authentication. You must create a GitHub App in your account or organization settings. The private key is a multi-line PEM file that should be stored securely using Docker secrets.
Info
For GitHub Enterprise Server, set CODEBASE_GITHUB_URL to your GitHub Enterprise URL (e.g., https://github.your-company.com). For GitHub.com, this variable can be omitted.
Automation: LLM Providers
This section documents the environment variables for each LLM provider.
Note
At least one of the supported providers should be configured to use the automation features.
OpenRouter (default)
| Variable | Description | Default | Example |
|---|---|---|---|
OPENROUTER_API_KEY |
OpenRouter API key | (none) | |
OPENROUTER_API_BASE |
OpenRouter API base URL | https://openrouter.ai/api/v1 |
Anthropic
| Variable | Description | Default | Example |
|---|---|---|---|
ANTHROPIC_API_KEY |
Anthropic API key | (none) |
OpenAI
| Variable | Description | Default | Example |
|---|---|---|---|
OPENAI_API_KEY |
OpenAI API key | (none) |
| Variable | Description | Default | Example |
|---|---|---|---|
GOOGLE_API_KEY |
Google API key | (none) |
Automation: Tools
This section documents the environment variables for each tool configuration used by AI agents.
Web Search
| Variable | Description | Default | Example |
|---|---|---|---|
AUTOMATION_WEB_SEARCH_MAX_RESULTS |
Maximum number of results to return from web search | 5 |
|
AUTOMATION_WEB_SEARCH_ENGINE |
Web search engine to use (duckduckgo, tavily) |
duckduckgo |
tavily |
AUTOMATION_WEB_SEARCH_API_KEY |
Web search API key (required if engine is tavily) |
(none) |
MCP Tools
MCP (Model Context Protocol) tools extend agent capabilities by providing access to external services and specialized functionality.
| Variable | Description | Default | Example |
|---|---|---|---|
MCP_PROXY_HOST |
Host URL for the MCP proxy server | http://mcp-proxy:9090 |
http://localhost:9090 |
MCP_PROXY_ADDR |
Address for the MCP proxy to listen on | :9090 |
:9090 |
MCP_PROXY_AUTH_TOKEN |
Authentication token for MCP proxy | (none) | secure-auth-token |
MCP_FETCH_ENABLED |
Enable/disable Fetch MCP server for web scraping | true |
false |
MCP_FETCH_VERSION |
Version of the Fetch MCP server | 2025.4.7 |
2025.4.7 |
MCP_SENTRY_ENABLED |
Enable/disable Sentry MCP server for error monitoring | true |
false |
MCP_SENTRY_VERSION |
Version of the Sentry MCP server | 0.17.1 |
0.17.1 |
MCP_SENTRY_ACCESS_TOKEN |
Sentry API access token | (none) | sntryu_abc123... |
MCP_SENTRY_HOST |
Sentry instance hostname | (none) | your-org.sentry.io |
Info
MCP tools are currently available in the Plan and Execute agent. The Fetch server provides web scraping capabilities, while the Sentry server enables error monitoring integration. For detailed configuration, see MCP Tools.
Note
Sentry MCP server requires both MCP_SENTRY_ACCESS_TOKEN and MCP_SENTRY_HOST to be configured for functionality.
Automation: AI Agents
This section documents the environment variables for each automation agent. Each agent uses a unique prefix for its variables.
All the default models where chosen to be the most effective models. You can change the models to use other models by setting the corresponding environment variables.
Plan and Execute
| Variable | Description | Default |
|---|---|---|
PLAN_AND_EXECUTE_PLANNING_RECURSION_LIMIT |
Recursion limit for planning steps each. | 100 |
PLAN_AND_EXECUTE_PLANNING_MODEL_NAME |
Model for planning tasks. | openrouter:anthropic/claude-sonnet-4.5 |
PLAN_AND_EXECUTE_PLANNING_THINKING_LEVEL |
Thinking level for planning tasks. | medium |
PLAN_AND_EXECUTE_EXECUTION_MODEL_NAME |
Model for executing tasks. | openrouter:anthropic/claude-sonnet-4.5 |
PLAN_AND_EXECUTE_EXECUTION_RECURSION_LIMIT |
Recursion limit for execution steps each. | 50 |
Review Addressor
| Variable | Description | Default |
|---|---|---|
REVIEW_ADDRESSOR_REVIEW_COMMENT_MODEL_NAME |
Model for review assessment. | openrouter:openai/gpt-4.1-mini |
REVIEW_ADDRESSOR_REPLY_MODEL_NAME |
Model for reply to comments/questions. | openrouter:openai/gpt-5-codex |
REVIEW_ADDRESSOR_REPLY_TEMPERATURE |
Temperature for the reply model. | 0.2 |
Pull Request Describer
| Variable | Description | Default |
|---|---|---|
PR_DESCRIBER_MODEL_NAME |
Model for PR describer. | openrouter:openai/gpt-4.1-mini |
Codebase Chat
| Variable | Description | Default |
|---|---|---|
CODEBASE_CHAT_MODEL_NAME |
Model for codebase chat. | openrouter:openai/gpt-5-mini |
CODEBASE_CHAT_TEMPERATURE |
Temperature for codebase chat. | 0.2 |