Встановлення

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

Що потрібно

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

Нова версія приходить тим самим шляхом, що й перша: за ключем, із перевіркою підпису. Сайти на час оновлення не зупиняються.

Якщо ліцензія закінчилася

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