Skip to content

Environment variables

With Docker Compose, all of these go in .env at the repository root (copied from deploy/.env.example). Backend defaults come from arnold-backend/arnold-server/config/local.yml.

Read by: B backend, U UI, R runner.

Core

Variable Read by Default Purpose
ARNOLD_UI_URL B, U http://localhost:3000 Public UI URL. Builds OAuth callback URLs and links in notifications
ARNOLD_API_URL U from api.* config Backend URL the UI proxies /api to
ARNOLD_URL R Backend URL runners call
ARNOLD_DEV_AUTH B true Development authentication. Must be false in production
ARNOLD_ADMINS B Emails or user ids granted superadmin, comma-separated
ARNOLD_ALLOW_DEV_AUTH U Must be true for the UI to start with auth.mode: dev
ARNOLD_AUTH_MODE U oauth Overrides auth.mode (oauth / dev)
ARNOLD_UI_JWT_SECRET B, U dev value Session JWT secret shared by UI and backend, ≥ 32 bytes
ARNOLD_RUNNER_API_KEY B, R Shared key runners use for the backend
ARNOLD_CREDENTIAL_ENCRYPTION_KEY B Base64 32-byte key for stored GitLab/GitHub tokens; required before connecting a provider

Storage

Variable Read by Default Purpose
AEROSPIKE_HOSTS B localhost Aerospike seed hosts, comma-separated (port 3000)
ELASTIC_ENABLED B false Enable the optional Elasticsearch analytics store
ELASTIC_HOST B localhost Elasticsearch host
ELASTIC_PORT B 9200
ELASTIC_SCHEME B http
ELASTIC_USERNAME B elastic
ELASTIC_PASSWORD B changeme

GitHub

Variable Read by Default Purpose
GITHUB_APP_ENABLED B false Enable GitHub
GITHUB_WEB_URL B https://github.com GitHub web URL (Enterprise Server: your host)
GITHUB_API_URL B https://api.github.com API URL (Enterprise Server: https://host/api/v3)
GITHUB_APP_ID B 0 Numeric App ID
GITHUB_APP_SLUG B App URL name, for the install link
GITHUB_APP_CLIENT_ID B Iv1.… / Iv23…
GITHUB_APP_CLIENT_SECRET B
GITHUB_APP_PRIVATE_KEY B PEM on one line with \n separators
GITHUB_APP_WEBHOOK_SECRET B Webhook HMAC secret
SCM_GITHUB_TOKEN R set per job Normally injected by the backend per job. Set by hand only for debugging

GitLab

Variable Read by Default Purpose
GITLAB_URL B https://gitlab.com GitLab base URL
GITLAB_OAUTH_CLIENT_ID B OAuth application id (scope api)
GITLAB_OAUTH_CLIENT_SECRET B
GITLAB_SERVICE_TOKEN B Optional read_api token: repository sync and feedback enrichment
GITLAB_WEBHOOK_SECRET B local-webhook-secret Expected X-Gitlab-Token on webhooks
GITLAB_ACCESS_TOKEN R Runner token to clone and comment (api)

Sync

Variable Read by Default Purpose
ARNOLD_REPOSITORY_SYNC_ENABLED B true Periodically import every open PR/MR
ARNOLD_REPOSITORY_SYNC_INTERVAL_SECONDS B 300 Interval
ARNOLD_GITLAB_SYNC_GROUPS B Comma-separated GitLab group ids/paths; empty = all of the service token's projects

LLM

Variable Read by Default Purpose
OPENCODE_ENABLED B true Offer OpenCode in Run Analysis
OPENCODE_PROVIDER B openai Model id prefix (openai/gpt-4.1)
OPENCODE_MODELS_URL B OpenAI-compatible base URL to list models
OPENCODE_API_KEY B Key for the model listing
CLIO_HARNESS R copilot Default harness: set to opencode
CLIO_LLM_BASE_URL R https://api.openai.com/v1 OpenAI-compatible endpoint for reviews
CLIO_LLM_API_KEY R Its key (OPENAI_API_KEY is also accepted)
CLIO_OPENCODE_MODEL R openai/gpt-4.1 Default OpenCode model
CLIO_OPENCODE_API_KEY R CLIO_LLM_API_KEY OpenCode-only key
CLIO_OPENCODE_BASE_URL R CLIO_LLM_BASE_URL OpenCode-only endpoint
CLIO_OPENCODE_TIMEOUT R 2700 OpenCode session timeout (s)
CLIO_LLM_MODEL R Default Copilot model
COPILOT_ENABLED B false Enable the opt-in Copilot harness
COPILOT_CLIENT_ID B GitHub OAuth App with device flow
COPILOT_ENCRYPTION_KEY B Base64 32-byte key for stored Copilot tokens

Runner dispatch

Variable Read by Default Purpose
ARNOLD_RUNNER_MODE B LOCAL LOCAL, GITLAB or GITHUB
RUNNER_GITLAB_PROJECT_ID B 0 GitLab runner project id
RUNNER_GITLAB_PROJECT_PATH B e.g. acme/arnold-runner
RUNNER_GITLAB_REF B main
RUNNER_GITLAB_TRIGGER_TOKEN B Pipeline trigger token
RUNNER_GITHUB_API_URL B https://api.github.com
RUNNER_GITHUB_REPOSITORY B e.g. acme/arnold-runner
RUNNER_GITHUB_WORKFLOW B arnold-runner.yml
RUNNER_GITHUB_REF B main
RUNNER_GITHUB_TOKEN B Token with actions: write on the runner repository
ARNOLD_RUNNER_CONCURRENCY R 1 Worker concurrency
ARNOLD_RUNNER_NAME R hostname Worker name prefix
ARNOLD_RUNNER_JOB_TIMEOUT R 9900 Per-job timeout (s)

Optional integrations (runner)

Variable Purpose
CLIO_AI_BOT_USER_ID Forge user id of the bot that posts inline suggestions
RFC_CENTRAL_API_URL, RFC_API_TOKEN Design-doc (RFC) content service for review context
IMPACT_SERVICE_URL, IMPACT_SERVICE_TOKEN Sink for post-merge impact data

Notifications (backend)

Variable Default Purpose
SLACK_API_URL https://slack.com Slack API URL (Slack notifications are disabled by default: slackClientConfig.enabled)
ARNOLD_SLACK_TOKEN Slack bot token