Установка

Одна команда на чистом сервере: загрузчик проверит машину и ключ, скачает подписанную сборку и поставит панель.

Что нужно

Ubuntu 22.04, 24.04, 26.04 или Debian 12, 13, архитектура x86_64, systemd, доступ root.
Память от 512 МБ, свободно на / от 8 ГБ. На малой машине установщик сам заведёт файл подкачки и настроит PostgreSQL скромнее.
Чистый сервер: если на нём уже стоит ISPmanager, Plesk, cPanel, CyberPanel, aaPanel, Hestia, Vesta или DirectAdmin, установка остановится.
Исходящий HTTPS к серверу лицензий. Входящие порты — 80 и 443 для сайтов и сертификатов.
Для микроВМ (Tier M и F в Pro и Host) — /dev/kvm. Без него работают только контейнеры Tier S.

Команда

Ключ активации приходит на почту после покупки или начала пробного периода, его же видно в кабинете. От root:

bash <(curl -fsSL https://getultrapanel.com/install.sh) --key UPL-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Без --key загрузчик спросит ключ сам. Полезные ключи:

Ключ	Что делает
`--domain panel.example.com`	имя панели; с ним панель сразу получит сертификат Let's Encrypt
`--email [email protected]`	логин первого администратора и контакт для удостоверяющего центра; без него загрузчик спросит
`--zfs-disk /dev/sdb`	отдельный диск под данные аккаунтов. Без него — файловый пул 24 ГБ (разрежённый), годится для пробы
`--force-move`	ключ уже работает на другом сервере — перенести лицензию сюда
`--version 1.2.0`	конкретная версия вместо последней стабильной
`--channel beta`	канал выпусков
`-y`	не задавать вопросов

Что происходит

Проверка машины: система, память, диск, чужие панели.
Проверка ключа: контрольный символ — на месте, затем запрос к серверу лицензий. Этот запрос лицензию не занимает: оборванная установка ничего не привязывает.
Манифест выпуска: список файлов и их SHA-256, подписанный ключом выпусков. Открытая половина ключа вшита в загрузчик — подменённую сборку он не поставит.
Скачивание с докачкой и сверкой каждого файла.
Установка из готовой сборки: компилятор и npm на сервере не нужны. В конце панель активирует ключ — с этого момента лицензия привязана к серверу.

Доступы первого администратора установщик печатает в конце и сохраняет в /root/.ultrapanel-first-admin. Без --domain панель открывается на порту 9443.

Ключ и лицензия на сервере

ultrapanel-ctl license             # редакция, срок, последняя связь
ultrapanel-ctl license set-key UPL-…  # сменить ключ
ultrapanel-ctl license refresh     # связаться с сервером лицензий сейчас
ultrapanel-ctl license release     # освободить лицензию перед переездом

Панель сверяется с сервером лицензий раз в несколько часов и держит подписанную аренду на 14 дней: короткий обрыв связи на работе не сказывается.

Переезд на другой сервер

Один ключ — один сервер. Чтобы поставить панель на новую машину, отвяжите старую в кабинете (или ultrapanel-ctl license release на ней) либо запустите установку с --force-move. Если старый сервер молчит больше трёх суток, лицензия перейдёт сама. Переносов — не больше трёх за 30 дней.

Обновление

ultrapanel-ctl upgrade

Новая версия приезжает тем же путём, что и первая: по ключу, с проверкой подписи. Сайты на время обновления не останавливаются.

Если лицензия истекла

После даты оплаты идёт льготная неделя. Затем запирается только управление: нельзя заводить аккаунты и менять настройки. Сайты, почта, продление сертификатов, резервные копии и приём платежей от ваших клиентов продолжают работать. Продление в кабинете снимает запрет при следующей сверке — или сразу, кнопкой «Проверить сейчас» на экране «Лицензия».