Skip to content

Orpheus configuration ​

Process settings are supplied through ENV. The application does not load .env itself. Compose does. The serve command flags take precedence for listener addresses.

VariableDefaultPurpose
DATABASE_URLrequiredPostgreSQL for API, worker and migrations
ORPHEUS_CONFIG_FILEorpheus.tomlCredential-store and service configuration path
ORPHEUS_MIGRATIONS_DIRmigrationsMigration directory. The --dir flag takes precedence
PUBLIC_API_KEYS[]JSON array of Bearer keys with equal access
ENV_ENCRYPTION_KEYrequired32-byte base64url key for environment encryption
HARNESS_ENV_ALLOWLIST[]JSON array of extra permitted worker ENV names. Combined with all service ENV names
AGENTBOX_API_KEYrequired on workerAgentBox access. Also supply to API for template registration
AGENTBOX_API_URLunsetExplicit AgentBox API origin. Use the same endpoint settings on API and worker
AGENTBOX_DOMAINagentbox-runtime.ruDomain used for https://api.<domain> when no explicit API URL is set
AGENTBOX_DEBUGfalseSelect http://localhost:3000 unless an explicit API URL is set
SANDBOX_PROXY_URLhttps://sandbox-proxy.agentbox.ru:65181Agent proxy: HTTP, HTTPS, SOCKS5 or SOCKS5H. Empty disables injection. See proxy and authentication compatibility
MAX_CONCURRENT_SESSIONS50Occupied execution slots, including preparation and finalization
DEFAULT_MAX_SESSION_TOKENS100000000Default token budget for new sessions
MAX_TOOL_RESULT_BYTES524288Retained tool output bytes
MAX_HOOK_OUTPUT_BYTES524288Retained hook stdout/stderr bytes
MAX_REQUEST_BYTES1048576API request body limit in bytes
DATABASE_PING_TIMEOUT2Database probe timeout, seconds
CANCEL_GRACE_SECONDS30Graceful cancellation wait, seconds
WORKER_POLL_SECONDS1Worker polling interval, seconds
SANDBOX_PROVISION_TIMEOUT_SECONDS120Initial sandbox creation and connection deadline, seconds. Applies to new attempts
SANDBOX_PAUSED_RETENTION_DAYS14Worker setting: paused reusable sandbox retention after the latest run finishes, integer 1–100 days
SANDBOX_CLEANUP_BATCH_SIZE1000Sessions selected per worker cleanup pass, including retries. Positive integer
RPC_TIMEOUT_SECONDS30Individual agent RPC timeout, seconds
ORPHEUS_HOST / ORPHEUS_PORT0.0.0.0 / 8000API listener
ORPHEUS_SYSTEM_HOST / ORPHEUS_SYSTEM_PORT0.0.0.0 / 9100Process probes and service metrics. Keep access within a trusted network
ORPHEUS_BROWSER_AUTHapi_onlyapi_only, anonymous or saml
ORPHEUS_PUBLIC_URLunsetExact external origin for browser writes. HTTPS required for SAML
SAML_SP_ENTITY_IDunsetSP entity ID
SAML_IDP_METADATA_FILEunsetPath to IdP metadata XML
SAML_SP_CERT_FILEunsetPath to SP certificate
SAML_SP_KEY_FILEunsetPath to SP private key
BROWSER_SESSION_TTL_SECONDS43200Browser session lifetime, 300-86400 seconds

required marks a required value. unset means no value is configured. SAML fields are required in saml mode. Supply integration variables such as HELPDESK_TOKEN to the worker. Register their names in a service, or use HARNESS_ENV_ALLOWLIST for names outside the catalog.

API and worker must share credential-store and service configuration, allowed environment names and encryption key. Recreate containers after ENV changes. Practical setup.