Установка (install)

Команда install используется для установки DoQA приложения.

Совет

Всегда используйте актуальную версию утилиты DoQA CLI. Скачайте свежую версию на странице Утилита управления сервером.

Linux
./doqa install

Флаги

  • --version <x.y.z> — указать версию конфигураций для установки. По умолчанию используется последняя версия.

Перед началом

  • Убедитесь, что выполнены требования и установлены Docker и Docker Compose.
  • Если планируете HTTPS/сертификаты, проверьте, что порты 80 и 443 свободны и доступны извне.
  • Если используете доменное имя (не localhost), настройте DNS, чтобы домен указывал на ваш сервер.

Шаги установки (интерактивно)

После запуска команда задаст вопросы:

  1. «Установить с базой данных?» —
    • Да: будет развёрнут PostgreSQL в составе DoQA, пароль для БД сгенерируется автоматически.
    • Нет: укажите параметры существующей БД (хост, порт, имя БД, пользователь, пароль).
  2. «Использовать SSL сертификат?» —
    • Да: будет включена SSL-конфигурация Nginx. Сертификаты можно подключить вручную или выпустить позже командой cert.
    • Нет: будет использована HTTP-конфигурация.
  3. «Введите домен для веб‑приложения» — домен без протокола (например: example.com или localhost).

Рекомендация

Если нет острой необходимости использовать уже существующий сервер PostgreSQL, рекомендуется выбрать PostgreSQL, входящий в состав DoQA. Это позволит пользоваться встроенными функциями резервного копирования (бекапа) — командой backup — и упростит обслуживание.

Пример ответов:

Вы хотите установить связь с базой данных: y
Использовать SSL сертификат?: y
Введите домен для веб-приложения: example.doqabox.ru

Важно

Домен указывается без протокола. Для корректной работы рекомендуется HTTPS.

Продакшн

В продакшене используйте DoQA только с SSL‑сертификатом. Без SSL часть функций DoQA будет недоступна (например, websockets), что повлияет на стабильность и UX.

Что делает команда

  • Создаёт служебные каталоги
  • Загружает набор конфигураций и распаковывает их.
  • Копирует configs/.env.install в .env и проставляет значения, генерирует секретные ключи.
  • Подготавливает Nginx и Docker Compose файлы.
  • Выполняет docker compose build.
  • Запускает миграции БД.

Что дальше

  • Для HTTPS используйте один из вариантов:
    • Выпустить сертификат автоматически: команда cert.
    • Подключить собственные сертификаты: поместите fullchain.pem и privkey.pem в box/nginx/ssl/.
  • Настройте почту для приглашения пользователей — см. Настройки почты.
  • Запустите приложение:
./doqa start
  • Откройте в браузере URL, соответствующий APP_URL (например: https://doqa.app/), завершите первичную настройку и создайте супер‑пользователя.
  • Если меняли домен — выполните domain, затем перевыпустите сертификаты через cert.