Self-hosted Buglapse работает по лицензионному ключу. Одна лицензия — один инстанс на одном домене. Ключ — длинная строка, начинающаяся с bgl1.; в нём записаны домен и срок действия, и подделать его нельзя. Ключ же открывает доступ к образам Buglapse в registry.

Лицензии — ваши, а не организации: они живут в вашем аккаунте на app.buglapse.com, на странице Self-hosted (меню пользователя). Там видны все инстансы, их ключи и сроки, и готовые команды установки. Облачная организация для этого не нужна.

Пробный период

Пробная лицензия — на 30 дней, выдаётся сразу, без заявки. Два способа:

• Из установщика — запустите его без ключа и нажмите Enter на вопросе о ключе (см. Установка). Он спросит домен и email и пришлёт на почту код; аккаунт на app.buglapse.com создастся по этому адресу сам — пароль к нему задаётся по ссылке из письма.
• В аккаунте — Self-hosted → Новый инстанс: домен и, если хотите, компания. Нужен подтверждённый email.

На один домен — одна пробная лицензия, на одного человека — до трёх. Повторная установка на тот же домен получает уже выданный ключ, а не новый.

Продление

Инстанс раз в сутки спрашивает у app.buglapse.com, нет ли для него ключа новее, и сам ставит его. Когда лицензию продлевают, делать на сервере ничего не нужно. Состояние видно в Администрирование → Лицензия: тип, домен, срок, когда последний раз проверялось продление и чем закончилось.

Чтобы купить лицензию или продлить её после пробного периода, напишите на support@buglapse.com.

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

Новый ключ можно вставить в Администрирование → Лицензия → Новый ключ. Или из консоли:

cd /opt/buglapse && docker compose exec app-blue php artisan license:install bgl1.…

(app-blue или app-green — см. ./buglapse status.) Ключ принимается, только если он выдан на домен инстанса, не истёк и не старше уже установленного.

Когда лицензия истекает

Когда	Что работает
До конца срока	Всё
14 дней после	Всё; над каждой страницей панели — баннер с датой остановки
Дальше	Панель, API, MCP и все собранные данные доступны; новые события не принимаются

После льготного периода SDK получают ответ 429 с просьбой подождать час и придерживают события — и наши, и Sentry SDK. Не работают и задачи, которые служат приёму: алерты, еженедельные отчёты, проверки доступности, отслеживание pull request Autofix. Данные не удаляются: как только установлен действующий ключ, всё продолжает работу.

Обновляться можно до версий, вышедших до конца срока ключа (плюс льготный период). Более новые версии registry выдаст после продления.

Смена домена

Ключ привязан к домену. Чтобы перенести инстанс на другой: Self-hosted в аккаунте → ваш инстанс → новый домен (не чаще раза в 30 дней). Выдаётся новый ключ на новый домен, а установка на старом домене его уже не получит. На сервере:

1. Направьте A-запись нового домена на сервер.

2. Поменяйте DOMAIN в .env и примените его:

   cd /opt/buglapse && sudo ./buglapse restart

3. Поставьте новый ключ вручную — до этого инстанс не принимает события: старый ключ выдан на другой домен.

DSN проектов меняются вместе с доменом — обновите их в приложениях.

Ключ любого домена подходит для localhost и 127.0.0.1 — для локальной установки отдельная лицензия не нужна.

Изолированная сеть

Buglapse работает и без доступа в интернет. Отличия:

• Продление — выключите автоматическое и ставьте новый ключ вручную до истечения текущего:

  LICENSE_RENEW=false

• Образы — загрузите их на сервер сами. На машине с интернетом:

  echo 'bgl1.…' | docker login registry.buglapse.com -u license --password-stdin
  V=1.0.0
  for image in registry.buglapse.com/buglapse/server:$V registry.buglapse.com/buglapse/panel:$V \
               postgres:17-alpine redis:7-alpine caddy:2.8-alpine; do docker pull "$image"; done
  docker save -o buglapse-$V.tar registry.buglapse.com/buglapse/server:$V \
      registry.buglapse.com/buglapse/panel:$V postgres:17-alpine redis:7-alpine caddy:2.8-alpine

  На сервере — docker load -i buglapse-1.0.0.tar. Скрипт установщика возьмите там же, где образы: curl -fsSL https://app.buglapse.com/api/self-hosted/install.sh -o install.sh.

• Установка — с версией, ключом и без входа в registry:

  sudo bash install.sh --no-login --version 1.0.0 --license bgl1.… --domain errors.example.com

• Обновление — загрузите образы новой версии (и промежуточных, если они есть по пути) так же и обновитесь с явной версией: ./buglapse upgrade --to 1.1.0.

Вместо docker save / docker load можно держать собственное зеркало registry и передать его адрес установщику: --registry registry.internal.example.com.

В изолированной сети оставьте пустым Настройки инстанса → Сеть → Uptime: URL проверки сети, а приватные адреса для мониторов и интеграций разрешите там же (см. Сеть).