Skip to content

Environment Variables

All Condrix services are configured through environment variables. Set them directly, in a .env file, or in your docker-compose.yml.

VariableDefaultDescription
CONDRIX_CORE_PORT9100WebSocket port the Core listens on
CONDRIX_CORE_HOST127.0.0.1Bind address. Use 0.0.0.0 for network/Docker access
CONDRIX_CORE_NAMEhostnameHuman-readable name shown in client UI
CONDRIX_CORE_DATA_DIR~/.condrixBase directory for workspaces, databases, and config
CONDRIX_CORE_CLAUDE_API_KEY—Claude API key (alternative to OAuth)
CONDRIX_CORE_TOKEN—Pre-seeded auth token for Maestro outbound connections and automated deployments
CONDRIX_CORE_LOG_LEVELinfoLogging verbosity: debug, info, warn, error
VariableDefaultDescription
CONDRIX_MAESTRO_URL—Maestro WebSocket URL (e.g., ws://maestro:9200)
CONDRIX_MAESTRO_TOKEN—Registration token (invite code) or permanent token for Core-to-Maestro authentication
CONDRIX_MAESTRO_SECRET—(Legacy) Shared secret for Core-to-Maestro authentication
VariableDefaultDescription
CONDRIX_CORE_TLS_CERT—Path to TLS certificate (PEM format)
CONDRIX_CORE_TLS_KEY—Path to TLS private key (PEM format)
VariableDefaultDescription
CONDRIX_CORE_TUNNEL_MODEdisabledTunnel mode: quick, named, or disabled
CONDRIX_CORE_TUNNEL_TOKEN—Cloudflare tunnel token (for named tunnels)
CONDRIX_CORE_TUNNEL_AUTO_STARTfalseStart tunnel automatically when Core starts
VariableDefaultDescription
CONDRIX_CORE_WORKSPACE_DIR~/.condrix/workspacesDirectory where workspaces are cloned
CONDRIX_CORE_CLONE_TIMEOUT300000Git clone timeout in milliseconds (default: 5 minutes)
VariableDefaultDescription
CONDRIX_MAESTRO_PORT9200WebSocket port Maestro listens on
CONDRIX_MAESTRO_HOST0.0.0.0Bind address
CONDRIX_MAESTRO_DATA_DIR~/.condrix/maestroDatabase and config directory
CONDRIX_MAESTRO_CORE_SECRET—Shared secret that Cores must present to register
CONDRIX_MAESTRO_CLIENT_AUTHdisabledClient authentication: enabled or disabled
CONDRIX_MAESTRO_LOG_LEVELinfoLogging verbosity: debug, info, warn, error
VariableDefaultDescription
CONDRIX_MAESTRO_TELEGRAM_TOKEN—Telegram bot token (from BotFather)
CONDRIX_MAESTRO_TELEGRAM_CHAT_ID—Telegram chat ID for notifications
CONDRIX_MAESTRO_WHATSAPP_ENABLEDfalseEnable WhatsApp bridge (requires QR pairing)

These variables are used in docker-compose.yml and .env files:

VariableDescription
MAESTRO_CORE_SECRETShared secret substituted into both Maestro and Core services
CLOUDFLARE_TUNNEL_TOKENToken for the cloudflared sidecar service
Terminal window
# Core
CONDRIX_CORE_PORT=9100
CONDRIX_CORE_HOST=0.0.0.0
CONDRIX_CORE_NAME=My Workstation
CONDRIX_CORE_LOG_LEVEL=info
# Maestro connection
CONDRIX_MAESTRO_URL=ws://maestro:9200
CONDRIX_MAESTRO_TOKEN=your-registration-or-permanent-token
# Maestro
CONDRIX_MAESTRO_PORT=9200
CONDRIX_MAESTRO_CORE_SECRET=change-me-to-a-secure-random-string
# Telegram notifications
CONDRIX_MAESTRO_TELEGRAM_TOKEN=123456:ABC-DEF...
CONDRIX_MAESTRO_TELEGRAM_CHAT_ID=987654321
# Tunnel
CONDRIX_CORE_TUNNEL_MODE=quick
CONDRIX_CORE_TUNNEL_AUTO_START=true

Environment variables take precedence over all other configuration sources:

  1. Environment variables (highest priority)
  2. .env file in the service’s working directory
  3. SQLite settings stored in the database
  4. Default values (lowest priority)

When running in Docker, variables set in docker-compose.yml under environment: take precedence over those in the .env file.