Skip to Content
ReferenceEnvironment Variables

Environment Variables

Gateway

VariableDefaultDescription
GATEWAY_ADDR:8080Gateway listen address
GATEWAY_AGENT_PUBLIC_KEYnoneRequired Ed25519 public key for agent auth
GATEWAY_API_KEYS_JSONnoneRequired API key JSON array
GATEWAY_IP_ALLOW_LISTemptyEmpty means no IP allow restriction
GATEWAY_TRUSTED_PROXY_CIDRSemptyEmpty means forwarded headers are ignored
GATEWAY_RATE_LIMIT_REQUESTS_PER_SECOND10Per-source request rate
GATEWAY_RATE_LIMIT_BURST20Per-source burst

Example

GATEWAY_ADDR=:8080 GATEWAY_AGENT_PUBLIC_KEY=TrMm87V3aET3MmGUzHf3_XKZRPEHe1bDM-POH1mrjr8 GATEWAY_API_KEYS_JSON='[{"name":"dev","key_hash":"$2a$10$INgs32pPDl8EQAOTcQ1NN.eZUpNkDtyTKXh2luqxE32vNBmaLpy7m","capabilities":["*"]}]' GATEWAY_IP_ALLOW_LIST= GATEWAY_TRUSTED_PROXY_CIDRS= GATEWAY_RATE_LIMIT_REQUESTS_PER_SECOND=10 GATEWAY_RATE_LIMIT_BURST=20

Agent

Most agent runtime settings are in capability.yaml. The file path itself can be selected with an environment variable.

VariableDefaultDescription
AGENT_CAPABILITY_FILEcapability.yamlPath to the agent capability YAML file

Important fields:

  • gateway.url
  • gateway.agent_private_key
  • database.driver
  • database.host
  • database.port
  • database.name
  • database.user
  • database.password
  • logging.max_size