Skip to content
Selu Docs

Environment Variables

Selu is configured primarily through environment variables. Set these in your .env file, in your Docker Compose configuration, or export them in your shell before running selu start.

Orchestrator

Section titled “Orchestrator”
VariableDefaultDescription
SELU_API_PORT8080Port the REST API listens on.
SELU_API_BASE_URLhttp://localhost:8080Public base URL. Set this when behind a reverse proxy or custom domain.
SELU_API_TOKEN—Bearer token for authenticating API requests. Generate with selu token create.
SELU_DATA_DIR/var/lib/seluDirectory for persistent data (conversations, agent state, secrets).
SELU_LOG_LEVELinfoLog verbosity: debug, info, warn, error.
SELU_LOG_FORMATtextLog format: text or json. Use json for structured log pipelines.
SELU_WEBHOOK_SECRET—Default HMAC secret for inbound webhook signature verification.
SELU_TLS_CERT—Path to TLS certificate file for HTTPS.
SELU_TLS_KEY—Path to TLS private key file for HTTPS.
SELU_CORS_ORIGINS*Comma-separated list of allowed CORS origins.

LLM providers

Section titled “LLM providers”
VariableDefaultDescription
SELU_OPENAI_API_KEY—API key for OpenAI models.
SELU_ANTHROPIC_API_KEY—API key for Anthropic models.
SELU_BEDROCK_REGIONus-east-1AWS region for Amazon Bedrock.
SELU_BEDROCK_ACCESS_KEY_ID—AWS access key ID for Bedrock. Falls back to standard AWS credential chain.
SELU_BEDROCK_SECRET_ACCESS_KEY—AWS secret access key for Bedrock.
SELU_OLLAMA_HOSThttp://localhost:11434Base URL for a local Ollama instance.

Channels

Section titled “Channels”
VariableDefaultDescription
SELU_TELEGRAM_BOT_TOKEN—Bot token from BotFather for the Telegram channel.
SELU_IMESSAGE_BRIDGE_PATH—Path to the iMessage bridge binary. Required for iMessage support.
SELU_WEB_CHAT_ENABLEDtrueEnable or disable the built-in web chat interface.
SELU_WEB_CHAT_PORT3000Port for the web chat UI.

Agent runtime

Section titled “Agent runtime”
VariableDefaultDescription
SELU_AGENT_GRPC_PORT50051Default gRPC port for agent-to-orchestrator communication.
SELU_AGENT_TIMEOUT120sMaximum time an agent has to respond before the orchestrator cancels the request.
SELU_CONTAINER_RUNTIMEdockerContainer runtime: docker or podman.
SELU_DOCKER_NETWORKselu-netDocker network name for inter-container communication.

Marketplace

Section titled “Marketplace”
VariableDefaultDescription
SELU_REGISTRY_URLhttps://registry.selu.ioURL of the agent/capability registry.
SELU_REGISTRY_TOKEN—Auth token for publishing to the registry.

Example .env file

Section titled “Example .env file”
.env
SELU_API_PORT=8080
SELU_LOG_LEVEL=info
SELU_LOG_FORMAT=json
SELU_DATA_DIR=/home/selu/data


# LLM
SELU_ANTHROPIC_API_KEY=sk-ant-...
SELU_OPENAI_API_KEY=sk-...


# Channels
SELU_TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
SELU_WEB_CHAT_ENABLED=true


# Marketplace
SELU_REGISTRY_URL=https://registry.selu.io
SELU_REGISTRY_TOKEN=reg_tok_...