Тема
Способы установки и требования
Kvalli — это один контейнер приложения и PostgreSQL. Всё работает в вашей инфраструктуре: приложение, база и все данные.
| Способ | Когда подходит |
|---|---|
| Один сервер: install.sh | Рекомендуется. Чистый Linux-сервер. Одна команда ставит Docker, PostgreSQL, HTTPS через Caddy и первого администратора, а дальше умеет обновлять с откатом, делать резервные копии и восстанавливать |
| Docker Compose вручную | У вас уже есть свой обратный прокси и свои правила для Docker-хостов |
| Kubernetes: Helm | Платформенная команда запускает приложения в кластере (OpenShift, Deckhouse, управляемый Kubernetes) и не возьмёт ВМ с Docker Compose |
Образ
Текущий выпуск — 2.3.0. Теги образа: полная версия (2.3.0), минорная (например, 2.2), мажорная (2) и latest. В установке закрепите конкретную версию и переходите на новую осознанно.
ghcr.io/kvalli-ai/kvalli-starter— бесплатная редакция Starter, публичная, токен не нужен.ghcr.io/kvalli-ai/kvalli— полная редакция для Pro и Enterprise, закрытая. Токен на чтение выдаётся вместе с лицензионным ключом.
Чем они отличаются — в разделе Тарифы и модули.
Собранный локально образ — только для пробы
Образ, собранный из исходников (docker compose up -d --build или docker build), не содержит открытого ключа лицензий. Он навсегда остаётся на Starter и не принимает лицензионные ключи.
Сервер
- Ubuntu 22.04 / 24.04 или Debian 12 — подойдёт любая система, где работает Docker.
- 2 vCPU, 4 ГБ памяти, 40 ГБ диска.
- Локальной модели через Ollama нужно ещё 8 ГБ памяти, а для моделей больше 7B — GPU.
- Для HTTPS: открытые порты 80 и 443 и DNS-имя, указывающее на сервер (
kvalli.acme.com).
Kubernetes
- Kubernetes 1.25+, Helm 3.
- StorageClass по умолчанию или явно заданный в values.
- Ingress-контроллер и TLS-сертификат для доступа снаружи.
- Запросы 0,75 CPU и 1,5 ГиБ памяти на приложение и встроенный PostgreSQL вместе; лимит до 3 ГиБ.
Одна копия приложения
Kvalli работает в одном экземпляре. Задания агентов и их потоки прогресса, счётчики ограничения запросов и счётчики ошибок хранятся в процессе. Несколько реплик будут считать лимиты раздельно, а браузер, подключённый к одной реплике, не увидит прогресс задания на другой. Если нагрузка растёт, дайте экземпляру больше CPU и памяти, а не добавляйте реплики.
Что дальше
После установки:
- войдите под администратором и смените пароль;
- установите лицензионный ключ, если он у вас есть;
- включите ночные резервные копии;
- заведите пользователей и проекты.