Skip to content

Environment Variables

VariableDefaultDescription
PORT3000HTTP/WebSocket server port
HOST0.0.0.0Bind address
ORCHESTRATOR_URLhttp://localhost:3000Backend API URL — used by MCP server for streaming endpoints
PORTAL_URLhttp://localhost:3001Portal frontend URL — used for sign-in redirect
NEXT_PUBLIC_ORCHESTRATOR_URLhttp://localhost:3000Client-side orchestrator URL for cross-app links
NEXT_PUBLIC_PORTAL_URLhttp://localhost:3001Client-side portal URL for cross-app links
VariableDefaultDescription
GITHUB_TOKEN(none)GitHub PAT — increases rate limit from 60 to 5,000 req/hr
AZURE_DEVOPS_PAT(none)Azure DevOps personal access token for ticket fetching
VariableAgentDescription
ANTHROPIC_API_KEYClaude CodeAnthropic API key (or authenticate via Claude OAuth token in the dashboard)
OPENAI_API_KEYCodexOpenAI API key
COPILOT_GITHUB_TOKENGitHub CopilotCopilot authentication token
GH_TOKENGitHub CopilotGitHub token for CLI operations
VariableDefaultDescription
ORCHESTRATOR_WS_URLws://localhost:3000/ws/workerWebSocket URL the agent connects to
WORKER_NAME(system hostname)Override the worker’s display name
AGENT_MODEbyomWorker mode — byom (bring-your-own-machine) or fleet
AGENT_CONFIG(none)Override YAML config file path (fleet mode)
DATA_DIR/dataData directory for volume isolation (fleet mode)
PODMAN_PATH(auto-detected)Override the Podman binary path
SECURITY_FLOOR(none)Enforced minimum security profile for containers

The CLI stores configuration in ~/.cropscode/config.json. The only user-configurable key is WORKER_NAME. Use cropscode config set to manage it.

See CLI: config for details.

Getting Started Concepts Guides CLI Self-Hosting Reference Links