Развёртывание стека

Установка — управляемая операция для технического специалиста. Ниже — порядок; полный справочник переменных в приложении A.

Поток установки (С-2)

Шаги

1. Распакуйте архив на подготовленном сервере:

   tar xzf voice-robot-box-1.0.0.tar.gz && cd box

2. Заполните .env — скопируйте пример и задайте параметры:

   cp .env.onprem.example .env

   Ключевое: CABINET_DOMAIN, ACME_EMAIL, MASTER_KEY (сгенерировать и сохранить отдельно), INTERNAL_TOKEN, SESSION_SECRET, ключи Yandex и S3. Генерация секретов:

   python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"  # MASTER_KEY
   openssl rand -hex 32   # INTERNAL_TOKEN, SESSION_SECRET

   MASTER_KEY

   MASTER_KEY — единственный способ расшифровать секреты кабинета. Храните его отдельно от сервера и бэкапа. При утере доступ к секретам теряется безвозвратно.

3. Поднимите стек хелпером (офлайн-архив — docker load образов + up -d без пересборки):

   ./load-and-up.sh

4. Создайте DNS A-запись CABINET_DOMAIN → <IP сервера>. Caddy автоматически выпустит TLS-сертификат при первом обращении.

Проверка результата

docker compose -f docker-compose.onprem.yml ps

Все контейнеры — в состоянии running/healthy. Дальше — веб-инсталлятор.