Настройки и переменные окружения

Переменные сервера: база, ключи, метрики, агенты, вебхук и что будет, если их не задать.

Статус: доступно обновлено 2026-10-28

Основные

Переменная	Что задаёт	Без неё
`DATABASE_URL`	Postgres с досками, IAM и журналом	сервис откажется стартовать, если база задана, но недоступна; без переменной работает режим диска
`PORT`	порт sync-сервиса	1234
`REMO_DATA_DIR`	каталог для режима диска	`apps/sync/.data`

Пример

# /srv/remo/.env, права 600, владелец — пользователь сервиса
DATABASE_URL=postgres://remo:<пароль>@127.0.0.1:5432/remo
NODE_ENV=production
PORT=1234
REMO_APP_ORIGIN=https://boards.example.com
REMO_CORS_ORIGIN=https://boards.example.com
REMO_METRICS_TOKEN=<32 случайных байта>
REMO_DATA_DIR=/var/lib/remo
REMO_KEK=<openssl rand -base64 32>
REMO_KEK_ID=v1

Безопасность и ключи

Переменная	Что задаёт
`REMO_KEK`	ключ-обёртка для секретов: 32 байта в base64
`REMO_KEK_ID`	версия ключа, по умолчанию `v1`
`REMO_APP_ORIGIN`	адрес приложения для ссылок в письмах и приглашениях
`REMO_CORS_ORIGIN`	разрешённый origin для API; `*` по умолчанию

Без REMO_KEK нельзя добавить ключ провайдера и настроить вебхук: сервер ответит WEBHOOK_LOCKED или AI_CREDENTIALS_LOCKED. Уже сохранённые секреты при потере ключа не расшифровываются.

Метрики

Переменная	Что задаёт
`REMO_METRICS_DATABASE_URL`	отдельная база продуктовых метрик
`REMO_METRICS`	`off` выключает инструментацию явно
`REMO_METRICS_TOKEN`	токен для `/metrics`; в production обязателен

Метрики никогда не пишутся в базу досок.

Агенты

Переменная	Что задаёт
`REMO_AI_API_KEY`, `REMO_AI_BASE_URL`, `REMO_AI_MODEL`	провайдер по умолчанию
`REMO_AI_TIMEOUT_MS`	таймаут вызова модели
`REMO_AGENT_MAX_TOKENS`, `REMO_AGENT_MAX_COST_USD`, `REMO_AGENT_MAX_ACTIONS`	верхние границы бюджета
`REMO_AGENT_MAX_QUEUED`	сколько задач может ждать одновременно

Без ключа задачи завершаются AI_NOT_CONFIGURED; остальной продукт работает.

Вебхук и отладка

Переменная	Что задаёт
`REMO_WEBHOOK_ALLOW_PRIVATE`	`1` разрешает эндпоинт во внутренней сети
`REMO_DEBUG`	подробные сообщения о подтверждениях сохранения
`REMO_VISITOR_SECRET`	секрет, которым подписывается идентификатор посетителя в голосовании; без него он меняется после перезапуска
`REMO_AI_PRICE_INPUT_PER_MTOK`, `REMO_AI_PRICE_OUTPUT_PER_MTOK`	цена токенов для расчёта стоимости задачи
`REMO_AI_ANCHOR_DIR`, `REMO_AI_ANCHOR_URL`, `REMO_AI_ANCHOR_TOKEN`	куда сервис пишет голову хеш-цепочки журнала

Куда дальше

Лимиты — значения по умолчанию для этих настроек.