Документ для реестра российского ПО и для заказчиков. Полное руководство администратора установки в контуре — infra/onprem/README.md (входит в комплект поставки). Версия документа: 22.09.2026.
1. Формы поставки
| Форма | Что нужно заказчику |
|---|---|
| Облачный сервис (SaaS) | браузер; доступ открывается по заявке, без самостоятельной регистрации |
| Установка в контуре (on-prem) | сервер под требования ниже; комплект поставки; интернет не нужен |
2. Требования к рабочему месту пользователя
Safari; включённые JavaScript и cookies.
навигация есть.
- Современный браузер последних версий: Яндекс Браузер, Chrome, Firefox,
- Разрешение экрана от 1280 px по ширине; интерфейс адаптивный, мобильная
3. Требования к серверу (установка в контуре)
| Что | Минимум |
|---|---|
| ОС | Linux x86_64 (проверено на Ubuntu 24.04; Astra Linux, РЕД ОС — к 01.06.2027) |
| Контейнеры | Docker Engine 24 и новее, Docker Compose v2.24 и новее |
| Процессор, память | 4 ядра, 16 ГБ |
| Диск | 60 ГБ свободно под Docker; данные растут |
| Сеть | одно имя в DNS заказчика; порты 80 и 443 (меняются) |
| Дополнительно | openssl, sha256sum (штатно есть); для ГОСТ-проверки — КриптоПро CSP или gost-engine для openssl (по желанию) |
Образы в комплекте: базовые закреплены по digest (infra/onprem/images/base.lock), слои с кодом приложения собираются заново на машине правообладателя и сверяются по хэшу до подписи; состав и результат проверки — в images/PROVENANCE.json комплекта.
| Интернет | не требуется ни для установки, ни для работы |
|---|
Состав служб в контуре: веб, API, фоновые задачи, ML-сервис, PostgreSQL 15, ClickHouse, Valkey (замена Redis), Caddy. Все образы — в комплекте, из внешних реестров ничего не скачивается (проверено на стенде: 0 обращений к реестрам образов).
4. Порядок установки в контуре
выпуска берётся с сайта abmpersona.ru/security/bundle или из документов поставки; проверка openssl dgst -verify и sha256sum -c.
``bash sudo ./install.sh --address abm.example.ru --admin-email it@example.ru \ --key-fingerprint "<отпечаток>" --org-name "Компания" --org-slug company --tls internal \ [--keys env|vault|passphrase] `` Установщик до любых изменений сверяет ключ и подпись, затем проверяет требования, загружает образы, создаёт ключи установки (или запечатывает их в Vault/OpenBao либо паролем), применяет миграции, лишает роль приложения прав суперпользователя (иначе изоляция организаций не действует), запускает службы, создаёт первую организацию и её владельца.
заказчика. Адреса прокси заказчика называются установщику (--trusted-proxy): иначе все пользователи за прокси делят один адрес — и блокировку входа после неудачных попыток.
30 дней ознакомления.
- Проверить подлинность комплекта до переноса в контур: отпечаток ключа
- Распаковать архив, запустить одной командой:
- Первый вход — разовый пароль владельца из
/opt/abm-persona/owner.txt. - Режимы TLS: встроенный центр сертификации, свои сертификаты или прокси
- Лицензия: код установки печатается установщиком; до установки лицензии —
5. Обновление, откат, резервные копии
<каталог нового комплекта> — она проверяет подпись нового комплекта закреплёнными ключами, делает резервную копию, применяет миграции; при сбое возвращает прежнюю версию и базы автоматически; ручной откат — upgrade.sh --rollback`.
копий — по правилам заказчика; ключи хранятся отдельно от копий.
(версии, состояние служб, очереди, блокировки выхода наружу, код установки и лицензия).
- Обновление запускает установленная копия: `sudo /opt/abm-persona/upgrade.sh
- Резервные копии:
backup.sh(PostgreSQL и ClickHouse), ротация и вынос - Диагностика для поддержки:
diag.sh— отчёт без персональных данных
6. Облачный сервис
Серверы — Selectel, ЦОД в Новосибирске (РФ), выделенный сервер; наружу открыты только веб и API по HTTPS. Резервная копия базы ежедневно плюс зашифрованная копия вне сервера; восстановление проверяется на отдельной машине.