Environment Variables

This reference is extracted from the current codebase validation schemas and compose runtime.

Container Image Namespace (Compose)

• GHCR_USERNAME

docker-compose.yml uses inline image URLs like ghcr.io/${GHCR_USERNAME}/oneglanse-web:latest.

Required Runtime Variables

• DATABASE_URL
• CLICKHOUSE_URL
• CLICKHOUSE_DB
• CLICKHOUSE_USER
• CLICKHOUSE_PASSWORD
• REDIS_HOST
• REDIS_PORT
• REDIS_PASSWORD
• BETTER_AUTH_URL
• NEXT_PUBLIC_API_URL
• APP_URL
• API_BASE_URL
• BETTER_AUTH_SECRET
• INTERNAL_CRON_SECRET

Agent Runtime Controls

• AGENT_WORKER_CONCURRENCY (default 1)
• DEBUG_ENABLED
• MIN_RESPONSE_CHARS
• Timeout and retry controls:
  • STEP_EXECUTION_TIMEOUT_MS
  • PAGE_DEFAULT_TIMEOUT_MS
  • PAGE_DEFAULT_NAVIGATION_TIMEOUT_MS
  • PROVIDER_HOOK_TIMEOUT_MS
  • MAX_EXTRACTION_RETRIES
  • EXTRACTION_RETRY_DELAY_MS
  • MAX_EXTRACTION_RETRY_DELAY_MS
  • AI_OVERVIEW_WAIT_TIMEOUT_MS
  • SUBMIT_METHOD_TIMEOUT_MS
  • MAX_PROMPT_RETRIES_PER_IP
  • PROMPT_RETRY_DELAY_MS
  • MAX_PROMPT_RETRY_DELAY_MS
  • SUBMISSION_PHASE_TIMEOUT_MS
• Proxy:
  • PROXY_URL
  • PROXY_SCHEME
  • PROXY_HOST
  • PROXY_PORT
  • PROXY_USERNAME (optional)
  • PROXY_PASSWORD (optional)
  • THORDATA_PROXY_API_URL (ThorData only)
• Browser fingerprint alignment:
  • BROWSER_LOCALE
  • BROWSER_TIMEZONE
  • BROWSER_ACCEPT_LANGUAGE

Provider Variables

• OPENAI_API_KEY (used by shared services)
• GOOGLE_CLIENT_ID
• GOOGLE_CLIENT_SECRET

Production Example

DATABASE_URL=postgresql://user:password@db:5432/mydb
CLICKHOUSE_URL=http://clickhouse:8123
CLICKHOUSE_DB=analytics
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=replace-me

REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=replace-me

APP_URL=http://web:3000
API_BASE_URL=http://web:3000
BETTER_AUTH_URL=https://app.domain.com
NEXT_PUBLIC_API_URL=https://app.domain.com

BETTER_AUTH_SECRET=replace-me
INTERNAL_CRON_SECRET=replace-me