Лицензия

Лицензионный ключ — короткое подписанное заявление об одной установке: для кого она, до какого числа и какого размера. Ключ проверяется по открытому ключу, вшитому в образ, поэтому установке в закрытой сети не нужно ни к кому обращаться, чтобы подтвердить лицензию.

Ключ можно прочитать: вы видите ровно то, что купили. Изменить его нельзя — подпись перестанет совпадать.

Без ключа Kvalli работает на бесплатном тарифе Starter. Что входит в тарифы — в разделе Тарифы и модули.

Установить ключ

install.sh:

sudo /opt/kvalli/install.sh install --domain kvalli.acme.com --email qa-lead@acme.com \
  --license-file ./acme.license

Docker Compose — в .env значение ключа:

KVALLI_LICENSE=kvalli-1.eyJpZCI6...

или путь к файлу, смонтированному в контейнер:

KVALLI_LICENSE_FILE=/run/secrets/kvalli.lic

Kubernetes — license.key в values.yaml или свой Secret через license.existingSecret.

Ключ Pro или Enterprise работает только на полном образе ghcr.io/kvalli-ai/kvalli. На образе Starter статус лицензии скажет, что нужен полный образ, — см. Переход со Starter на Pro.

Ничего не перестаёт работать

Kvalli стоит внутри вашего процесса поставки. Если бы он отказывался запускаться из-за ключа, истёкшего в выходные, остановились бы ваши релизы. Поэтому лицензия ничего не блокирует. Установка с истёкшим, недействительным, отозванным или превышенным ключом продолжает работать и сообщает об этом:

• предупреждением в логе при запуске;
• в GET /api/admin/license;
• баннером над всеми экранами у администратора установки.

Ключ, у которого истёк срок или превышены лимиты, сохраняет свои модули. У истёкшего ключа есть 30 дней льготного периода, прежде чем он вообще будет считаться истёкшим.

Состояния

Состояние	Что значит
licensed	В пределах дат и лимитов ключа
grace	Срок истёк меньше 30 дней назад
expired	Льготный период закончился
over_limit	Проектов или активных пользователей больше, чем разрешает ключ
invalid	Ключ изменён, выпущен для другой сборки или ещё не начал действовать
revoked	Ключ отозван; установка работает как Starter, данные сохраняются
starter	Ключа нет: бесплатный тариф

Использование считается в проектах и активных аккаунтах. Отключённые аккаунты не считаются.

Что видит администратор

Когда ключ требует внимания — grace, expired, over_limit, invalid, revoked, — администратор установки видит баннер над каждым экраном: что не так, что это значит и, для лимита, сколько используется из купленного. Баннер можно скрыть, он вернётся при следующем визите. На Starter баннера нет: работа без ключа — нормальный режим этого тарифа.

На Enterprise состояние лицензии показывает и карточка на странице Настройки → Система.

Отзыв ключа

Отозванный ключ попадает в сборку: следующий выпуск Kvalli знает его как отозванный. Установка с таким ключом переходит на Starter, данные остаются на месте, а модули возвращаются с новым ключом.