Переменные окружения
Переменные окружения платформы EVA: что обязательно задать в продакшене, что можно оставить по умолчанию и что настраивается не через окружение, а в интерфейсе.
Ключи провайдеров моделей, ёмкость рантайма, брендинг, OnlyOffice и LDAP настраиваются в интерфейсе и хранятся в базе. В окружении их нет.
Режим
| Переменная | Значение |
|---|---|
EVA_MODE | cloud по умолчанию или local для Desktop |
EVA_CLOUD_URL | Только local: адрес облачной EVA для входа, моделей и пакетов |
EVA_DATA_DIR | Только local: папка данных, по умолчанию ~/.eva |
API
| Переменная | Значение |
|---|---|
PORT, HOST | Адрес API, по умолчанию 3000 и 0.0.0.0 |
PUBLIC_API_URL | Публичный адрес API. Должен быть доступен из контейнеров MCP |
API_URL | Адрес API для Runtime и Package-pool внутри пода |
DATABASE_URL | Строка подключения PostgreSQL |
SESSION_SECRET | Секрет подписи сессий. Обязательно свой в продакшене |
SESSION_TTL_DAYS | Срок жизни сессии, по умолчанию 14 |
SESSION_FILES_DIR | Папка файлов чатов, по умолчанию .data/session-files |
PREVIEW_TOKEN_TTL_SEC | Срок токена предпросмотра файлов, по умолчанию 1200 |
PRICING_CURRENCY | Валюта цен и лимитов расходов, например RUB. Должна совпадать с валютой панели ZeBrains Gate |
AGENT_SCHEDULER_INTERVAL_MS | Период планировщика агентов, по умолчанию 30000. 0 выключает, обязательно на всех репликах кроме одной |
SEED_ADMIN_LOGIN, SEED_ADMIN_PASSWORD | Первый администратор при seed |
Runtime
| Переменная | Значение |
|---|---|
RUNTIME_URL | Адрес Runtime для API |
RUNTIME_HOST, RUNTIME_PORT | Где слушает Runtime, по умолчанию 127.0.0.1:3001 |
MAX_AGENT_STEPS | Максимум шагов модели за один ход, по умолчанию 120 |
Package-pool и пакеты
| Переменная | Значение |
|---|---|
PACKAGE_POOL_URL, PACKAGE_POOL_HOST, PACKAGE_POOL_PORT | Адрес Package-pool, по умолчанию 127.0.0.1:3022 |
EVA_PACKAGE_ISOLATE | Режим запуска кода пакетов: host, secure-exec, stub |
PACKAGE_STORE | Хранилище пакетов |
PACKAGE_DRAFTS_DIR | Черновики Студии. Должны лежать внутри PACKAGE_HOST_DATA_ROOT |
PACKAGE_WORKSPACE_DIR | Рабочие папки пакетов |
PACKAGE_HOST_DATA_ROOT | Корень данных, за пределы которого Package-pool не выходит |
AGENT_ARTIFACTS_DIR | Артефакты запусков агентов |
EVA_NPM_UPSTREAM_REGISTRY | Upstream npm-реестр, переопределяет значение из настроек платформы |
EVA_DESKTOP_ARTIFACTS_DIR | Где лежат сборки сервисов Desktop, которые отдаёт API |
По умолчанию все пути пакетов лежат под apps/api/.data, поэтому достаточно одного тома.
MCP
| Переменная | Значение |
|---|---|
MCP_DISCOVER_TIMEOUT_MS | Таймаут получения списка инструментов, по умолчанию 8000 |
MCP_CATALOG_TTL_MS | Кэш каталога инструментов, по умолчанию 60000 |
MCP_TOOL_CALL_TIMEOUT_MS | Таймаут вызова инструмента, по умолчанию 600000 |
MCP_GATEWAY_SESSION_TTL_MS | Срок сессии MCP-шлюза, по умолчанию 1800000 |
OnlyOffice
ONLYOFFICE_URL, ONLYOFFICE_PLATFORM_URL, ONLYOFFICE_TOKEN_TTL_SEC задают только начальные значения при первом создании настроек. Дальше параметры меняются в Админ → Настройки.
Веб-интерфейс при сборке
| Переменная | Значение |
|---|---|
VITE_API_URL | Адрес API для браузера. Пусто означает тот же origin |
VITE_BASE_URL | Базовый путь интерфейса, по умолчанию / |