Описание параметров среды (.env)
Файл .env в каталоге установки задаёт настройки всех сервисов DoQA. Он создаётся командой install из поставляемого шаблона.
Значения .env попадают в контейнеры при их создании, поэтому правка применяется только после перезапуска приложения: ./doqa stop && ./doqa start.
Почта (обязательно к изменению)
MAIL_MAILER, MAIL_HOST, MAIL_PORT, MAIL_ENCRYPTION, MAIL_USERNAME, MAIL_PASSWORD, MAIL_FROM_ADDRESS, MAIL_FROM_NAME.
Без настроенной почты нельзя приглашать пользователей и восстанавливать пароли. Подробно: Настройка сервера почты.
Домен и SSL (обязательно для продакшна)
| Параметр | Описание и пример |
|---|---|
APP_URL | Домен приложения без протокола. Пример: example.com. Менять: командой domain. |
APP_FRONTEND_URL | Домен фронтенда (обычно равен APP_URL). Пример: example.com. Менять: командой domain. |
USE_SSL | Включить HTTPS. Пример: true/false. Менять: командой cert или вручную при подключении своих сертификатов. |
MINIO_BUCKET_URL | Публичный URL бакета. Пример: https://example.com/doqa. Менять: командами domain, cert. |
Продакшн
Используйте реальный домен с A‑записью на сервер и USE_SSL=true. Без SSL часть функций (веб-сокеты) недоступна.
Аутентификация
| Параметр | Описание |
|---|---|
LDAP_ENABLED | Вход по учётным данным из LDAP-каталога. Подробно: Авторизация через LDAP. |
SSO_ENABLED | Корпоративный вход через провайдера OIDC. Подробно: Корпоративный вход (SSO). |
Ни один параметр LDAP_* и SSO_* в шаблон .env не входит, включая перечисленные выше LDAP_ENABLED и SSO_ENABLED — все нужные строки добавляют в файл вручную.
Ключи и безопасность (менять не рекомендуется)
Значения генерируются при установке. Смена ключей разлогинит пользователей.
| Параметр | Описание |
|---|---|
APP_KEY | Ключ приложения. Пример: base64:.... |
JWT_SECRET | Секрет для подписи токенов доступа. |
MINIO_KEY | Ключ доступа к файловому хранилищу MinIO. |
MINIO_SECRET | Секрет доступа к MinIO. |
PUSHER_APP_SECRET | Секрет сервиса веб‑сокетов. |
STATISTIC_API_KEY | Ключ сервиса статистики. |
NOTIFICATION_API_KEY | Ключ сервиса уведомлений. |
LLM_API_KEY | Ключ сервиса ИИ-функций. |
RABBITMQ_PASSWORD | Пароль брокера сообщений. |
RABBITMQ_ERLANG_COOKIE | Cookie кластера RabbitMQ. |
База данных (менять для внешней БД)
| Параметр | Описание и пример |
|---|---|
DB_HOST | Хост БД. Пример: postgres (встроенная PostgreSQL) или db.example.com. |
DB_PORT | Порт БД. Пример: 5432. |
DB_DATABASE | Имя БД. Пример: doqa. |
DB_USERNAME | Пользователь БД. Пример: root. |
DB_PASSWORD | Пароль БД. |
Внешняя БД и обслуживание
Команды backup и restore работают только со встроенной PostgreSQL. При подключении к внешней БД настраивайте резервное копирование средствами своего сервера БД.
Redis (менять для внешнего Redis)
| Параметр | Описание и пример |
|---|---|
REDIS_HOST | Хост Redis. Пример: redis. |
REDIS_PASSWORD | Пароль Redis. Пример: null или s3cret. |
REDIS_PORT | Порт Redis. Пример: 6379. |
REDIS_DB | Индекс БД Redis для приложения. Пример: 2. Базы 0 и 1 заняты брокером и результатами задач — не занимайте их. |
REDIS_CACHE_DB | Индекс БД Redis под кэш. Пример: 3. |
RabbitMQ (менять для внешнего брокера)
Брокер сообщений используется конвейером автотестов: через него результаты запусков попадают из парсера в приложение.
| Параметр | Описание и пример |
|---|---|
RABBITMQ_HOST | Хост брокера. Пример: rabbitmq. |
RABBITMQ_PORT | Порт брокера. Пример: 5672. |
RABBITMQ_USER | Пользователь. Пример: admin. |
RABBITMQ_VIRTUAL_HOST | Виртуальный хост. Пример: /. |
Очереди
| Параметр | Описание и пример |
|---|---|
QUEUE_WORKERS | Число параллельных обработчиков фоновых задач. Пример: 3. Через очереди уходят письма, импорт и экспорт. Увеличьте, если фоновые задачи копятся. |
Веб‑сокеты
Обновляют интерфейс без перезагрузки страницы. Требуют USE_SSL=true.
| Параметр | Описание и пример |
|---|---|
BROADCAST_DRIVER | Драйвер трансляции событий. Пример: pusher. |
PUSHER_APP_HOST | Хост сервиса веб‑сокетов. Пример: websocket. |
PUSHER_APP_ID | Идентификатор приложения. Пример: web-socket. |
PUSHER_APP_KEY | Ключ приложения. Пример: web-socket. |
PUSHER_APP_PORT | Порт. Пример: 6001. Менять: только при конфликте портов. |
PUSHER_SCHEME | Протокол. Пример: http. |
Порты
| Параметр | Описание и пример |
|---|---|
SERVER_PORT | HTTP порт снаружи. Пример: 80. Менять: только при конфликте. |
SERVER_SSL_PORT | HTTPS порт снаружи. Пример: 443. Менять: только при конфликте. |
Сервисы
| Параметр | Описание и пример |
|---|---|
MINIO_ENDPOINT | Внутренний адрес MinIO. Пример: http://minio:9000. |
MINIO_BUCKET | Имя бакета. Пример: doqa. |
MINIO_REGION | Регион MinIO. Пример: ru-1. |
STATISTIC_ENDPOINT | Внутренний адрес сервиса статистики. Пример: http://statistic:3000/. |
NOTIFICATION_ENDPOINT | Внутренний адрес сервиса уведомлений. Пример: http://notification:3000/. |
LLM_ENDPOINT | Внутренний адрес сервиса ИИ-функций. Пример: http://llm:3000/. Подробно: Настройки DoQA AI. |
Telegram-бот уведомлений
Заполняется, если пользователи получают уведомления в Telegram. Пока эти параметры не заданы, блок подключения бота в профиле пользователя не показывается, а переключатели в колонке «Telegram» остаются неактивными. Остальные каналы («E-mail», «DoQA») от этого не зависят.
| Параметр | Описание |
|---|---|
BOT_TOKEN | Токен бота, выданный BotFather. |
BOT_NAME | Имя бота без символа @. Подставляется в ссылку на чат с ботом в профиле пользователя. |
Docker‑образы (служебные)
Значения обновляются автоматически при установке и обновлении. Редактировать вручную не требуется.
IMAGE_DOQA_API— бэкенд, напримерregistry.control.doqa.app/doqa/doqa-backend:<версия>-box.IMAGE_DOQA_FRONTEND— интерфейс.IMAGE_DOQA_AUTOTEST_PARSER— парсер автотестов.IMAGE_DOQA_AUTOTEST_RESULT_PARSER— парсер результатов автотестов.IMAGE_DOQA_STATISTIC— сервис статистики.IMAGE_DOQA_NOTIFICATION— сервис уведомлений.IMAGE_DOQA_TG_BOT— Telegram-бот.IMAGE_DOQA_LLM— сервис ИИ-функций.