All environment variables that FideliOS uses for server configuration.

Server Configuration

VariableDefaultDescription
PORT3100Server port
HOST127.0.0.1Server host binding
DATABASE_URL(embedded)PostgreSQL connection string
FIDELIOS_HOME~/.fideliosBase directory for all FideliOS data
FIDELIOS_INSTANCE_IDdefaultInstance identifier (for multiple local instances)
FIDELIOS_DEPLOYMENT_MODElocal_trustedRuntime mode override

Secrets

VariableDefaultDescription
FIDELIOS_SECRETS_MASTER_KEY(from file)32-byte encryption key (base64/hex/raw)
FIDELIOS_SECRETS_MASTER_KEY_FILE~/.fidelios/.../secrets/master.keyPath to key file
FIDELIOS_SECRETS_STRICT_MODEfalseRequire secret refs for sensitive env vars

Agent Runtime (Injected into agent processes)

These are set automatically by the server when invoking agents:
VariableDescription
FIDELIOS_AGENT_IDAgent’s unique ID
FIDELIOS_COMPANY_IDCompany ID
FIDELIOS_API_URLFideliOS API base URL
FIDELIOS_API_KEYShort-lived JWT for API auth
FIDELIOS_RUN_IDCurrent heartbeat run ID
FIDELIOS_TASK_IDIssue that triggered this wake
FIDELIOS_WAKE_REASONWake trigger reason
FIDELIOS_WAKE_COMMENT_IDComment that triggered this wake
FIDELIOS_APPROVAL_IDResolved approval ID
FIDELIOS_APPROVAL_STATUSApproval decision
FIDELIOS_LINKED_ISSUE_IDSComma-separated linked issue IDs

LLM Provider Keys (for adapters)

VariableDescription
ANTHROPIC_API_KEYAnthropic API key (for Claude Local adapter)
OPENAI_API_KEYOpenAI API key (for Codex Local adapter)