Appearance
Environment Variables
Complete reference for all environment variables used by EleAgent.
Server
| Variable | Default | Description |
|---|---|---|
PORT | 3001 | HTTP listen port for the controller |
HOST | 0.0.0.0 | Bind address (use 127.0.0.1 to restrict to localhost) |
VITE_PORT | 5173 | Vite dev server port (development only) |
ROLE | (unset) | Container role: controller or worker. Unset = monolith mode |
Authentication
| Variable | Default | Description |
|---|---|---|
JWT_SECRET | change-me-in-production | Secret for signing JWT session tokens. Must be changed. |
ANTHROPIC_API_KEY | (unset) | API key for Anthropic model access. Alternative to Max login. |
Storage
| Variable | Default | Description |
|---|---|---|
HOME | /artefacts/state/home | Home directory inside container (stores .claude credentials) |
ARTEFACTS_ROOT | /artefacts | Base directory for all writable state |
DATABASE_PATH | /artefacts/state/auth.db | Path to the authentication SQLite database |
SESSION_REGISTRY_DB | /artefacts/state/session_registry.db | Path to the session slot manager database |
Sessions
| Variable | Default | Description |
|---|---|---|
MAX_ACTIVE_SESSIONS | 5 | Maximum concurrent AI query executions |
SESSION_LOCK_TTL_SECONDS | 120 | Lock expiry time without heartbeat (seconds) |
Agent Behavior
| Variable | Default | Description |
|---|---|---|
SYSTEM_PROMPT_FILE | /config/system_prompt.md | Path to the mounted system prompt file |
HOST_SOURCE_BASE | (unset) | Host path prefix for file citations in agent responses |
CONTEXT_WINDOW | 160000 | Token budget for the AI model |
VITE_CONTEXT_WINDOW | 160000 | Token budget displayed in the frontend UI |
Workspace
| Variable | Default | Description |
|---|---|---|
WORKSPACES_ROOT | /data | Root directory for project browsing (read-only) |
Feature Flags
| Variable | Default | Description |
|---|---|---|
DISABLE_MCP | true | Disable MCP server integration (backend) |
VITE_DISABLE_MCP | true | Hide MCP UI elements (frontend) |
VITE_IS_PLATFORM | false | Platform vs. self-hosted mode |
ENABLE_SYSTEM_UPDATE | false | Enable/disable the self-update mechanism |
Worker-Specific
| Variable | Default | Description |
|---|---|---|
WORKER_PORT | 3002 | HTTP listen port for worker containers |
WORKER_URLS | (unset) | Comma-separated WebSocket URLs of workers (controller only) |
HTTPS_PROXY | http://egress-proxy:3128 | Egress proxy URL for outbound HTTPS |
HTTP_PROXY | http://egress-proxy:3128 | Egress proxy URL for outbound HTTP |
NO_PROXY | localhost,127.0.0.1,eleask-controller | Addresses that bypass the proxy |
Docker Compose Variables
These are set in the .env file and consumed by docker-compose.yml:
| Variable | Default | Description |
|---|---|---|
DATA_PATH | ../data | Host path to project data files |
ARTEFACTS_PATH | ./artefacts | Host path for writable artefacts |
SYSTEM_PROMPT_PATH | ./config/system_prompt.md | Host path to system prompt file |
HOST_PORT | 3001 | Port exposed on the host machine |
CONTAINER_UID | 10001 | UID for the container user |
CONTAINER_GID | 10001 | GID for the container group |