Установка

Voxagent поставляется как набор Docker-образов в приватном container registry + публичный бандл docker-compose.yml + .env.example, который связывает все сервисы.

Поддерживаются три варианта установки:

1. Quickstart (один хост, Docker Compose)

Самый быстрый способ попробовать Voxagent — один docker compose up поднимает весь стек на машине 4 vCPU / 8 GB. Пошаговый гайд — в Быстром старте.

Подходит для: демо, локальной разработки, пилотов до ~10 одновременных сессий.

2. Compose на прод-VM

Тот же compose-файл что в quickstart, развёрнутый на правильно подобранной Linux-VM (см. Требования). Используется тот же публичный docker-compose.yml, но с секретами и увеличенными лимитами ресурсов.

Подходит для: небольшого/среднего прода до ~50 одновременных сессий, single-tenant.

3. Managed / Railway / Kubernetes

Каждый сервис доступен как отдельный контейнер — можно развернуть в Railway, ECS, Kubernetes или любом оркестраторе. В проде мы крутим Voxagent на Railway с managed Postgres, Redis и Kafka.

Напишите нам, если нужны Helm-чарты или Terraform-модули — поможем настроить под ваше окружение.

Что нужно перед стартом

• Deployment-токен для container registry (см. ниже).
• Хост под Требования.
• Аккаунты во внешних сервисах, которые планируете включить: LLM-провайдер, STT-провайдер, TTS-провайдер, Stripe (биллинг), Mailgun или аналог (email).

Получение deployment-токена

Образы лежат в registry.gitlab.com/nodevoice/*. Они не публичные — каждому клиенту выдаётся свой read-only токен.

Как запросить: откройте issue в репо quickstart или напишите нам — мы выдадим токен.

Залогиньтесь на хосте:

docker login registry.gitlab.com -u <имя-токена> -p <секрет-токена>

После этого docker compose pull скачает все нужные образы.