Переменные окружения
Бэкенд настраивается через единственный файл .env. В автоматической установке он находится в /root/copula/.env (права 0600); при ручной установке это .env, который вы создаёте по готовому шаблону со страницы Ручная установка.
Основные
| Переменная | По умолчанию | Описание |
|---|---|---|
BACKEND_PORT | 8080 | Порт, который бэкенд слушает внутри контейнера. Compose-стеки публикуют на него порт хоста 8901. |
LOG_LEVEL | — | Детализация логирования. |
CORS_ALLOWED_ORIGINS | * | Разрешённые CORS-источники. |
JWT_SECRET | — | Обязательная. Секрет подписи JWT; ровно 128 hex-символов. |
ENCRYPTION_KEY | — | Обязательная. Ключ шифрования AES-256; 32 символа. |
LICENSE_TOKEN | — | Обязательная. Лицензионный токен из кабинета; также bearer-токен для LLM-роутера кабинета. |
CABINET_URL | https://api.copul4.com | Endpoint API кабинета. |
ADMIN_USER / ADMIN_PASS | — | Начальные учётные данные администратора; бэкенд автоматически создаёт из них аккаунт администратора. |
База данных
| Переменная | По умолчанию | Описание |
|---|---|---|
POSTGRES_HOST | postgres | Хост PostgreSQL. |
POSTGRES_PORT | 5432 | Порт PostgreSQL. |
POSTGRES_USER | agent | Пользователь базы данных. |
POSTGRES_PASSWORD | (пусто) | Пароль базы данных. |
POSTGRES_DB | agentdb | Имя базы данных. |
Провайдер моделей
| Переменная | По умолчанию | Описание |
|---|---|---|
MODEL_PROVIDER | openrouter | openrouter, custom или copula. Пустое значение означает openrouter; неизвестное значение логирует fatal-сообщение и откатывается к openrouter. |
MODEL_BASE_URL | https://openrouter.ai/api/v1 | Базовый URL OpenAI-совместимого API. |
MODEL_API_KEY | — | API-ключ провайдера (для copula не нужен — учётные данные это лицензионный токен). |
MODEL_NAME | — | Имя модели. В новых установках через мастер по умолчанию copula-base. |
MODEL_MAX_TOKENS | 25000 | Максимум токенов в ответе модели. |
Профили Smart / Basic
SMART_MODEL_* и BASIC_MODEL_* переопределяют значения MODEL_* для каждого профиля. Разрешение каждого значения идёт по цепочке fallback SMART_* → BASIC_* → MODEL_*.
| Группа переменных | Назначение |
|---|---|
SMART_MODEL_PROVIDER / SMART_MODEL_BASE_URL / SMART_MODEL_API_KEY / SMART_MODEL_NAME / SMART_MODEL_MAX_TOKENS | Переопределения для smart-профиля (тяжёлый). |
BASIC_MODEL_PROVIDER / BASIC_MODEL_BASE_URL / BASIC_MODEL_API_KEY / BASIC_MODEL_NAME / BASIC_MODEL_MAX_TOKENS | Переопределения для basic-профиля (лёгкий). |
Также распознаются устаревшие ключи провайдеров OPENROUTER_API_KEY и MINIMAX_API_KEY.
Агенты и рантайм
| Переменная | По умолчанию | Описание |
|---|---|---|
AGENT_WORKSPACE | — | Путь к рабочей директории репозиториев агентов. |
AGENT_CONTEXT_TOKEN_LIMIT | 120000 | Лимит токенов контекста агента. |
MAX_REPO_WORKERS | 20 | Максимум одновременных воркеров репозиториев. |
SESSION_STORAGE_TYPE | — | database или file. |
SESSION_FILE_PATH | — | Путь для файлового хранилища сессий. |
FILE_STORAGE_PATH | ./uploads | Куда сохраняются загруженные файлы. |
MAX_FILE_SIZE_MB | 50 | Максимальный размер загрузки. |
Интеграции и обновления
| Переменная | По умолчанию | Описание |
|---|---|---|
SP_DISTRIBUTOR_URL | https://get.copul4.com | Endpoint дистрибьютора. |
SELF_UPDATE_IMAGE | — | Опциональное переопределение ссылки на образ, используемой при проверках доступности self-update. |
COCOINDEX_CODE_IMAGE | cocoindex/cocoindex-code:full | Переопределение образа поиска по коду (уровень compose). |