Instalacja

Jedno polecenie na czystym serwerze: skrypt instalacyjny sprawdzi maszynę i klucz, pobierze podpisaną kompilację i zainstaluje panel.

Wymagania

Ubuntu 22.04, 24.04, 26.04 lub Debian 12, 13, architektura x86_64, systemd, dostęp root.
Pamięć od 512 MB, wolne miejsce na / od 8 GB. Na małej maszynie instalator sam utworzy plik wymiany i skromniej skonfiguruje PostgreSQL.
Czysty serwer: jeśli jest już na nim ISPmanager, Plesk, cPanel, CyberPanel, aaPanel, Hestia, Vesta lub DirectAdmin, instalacja się zatrzyma.
Wychodzący HTTPS do serwera licencji. Porty przychodzące — 80 i 443 dla stron i certyfikatów.
Dla mikromaszyn wirtualnych (Tier M i F w Pro i Host) — /dev/kvm. Bez niego działają tylko kontenery Tier S.

Polecenie

Klucz aktywacyjny przychodzi e-mailem po zakupie lub rozpoczęciu okresu próbnego, jest też widoczny na koncie licencji. Jako root:

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

Bez --key skrypt instalacyjny sam zapyta o klucz. Przydatne opcje:

Opcja	Co robi
`--domain panel.example.com`	nazwa panelu; z nią panel od razu otrzyma certyfikat Let's Encrypt
`--email [email protected]`	login pierwszego administratora i kontakt dla urzędu certyfikacji; bez tej opcji skrypt zapyta
`--zfs-disk /dev/sdb`	osobny dysk na dane kont. Bez niego — pula w pliku 24 GB (plik rzadki), wystarczy do wypróbowania
`--force-move`	klucz działa już na innym serwerze — przenieś licencję tutaj
`--version 1.2.0`	konkretna wersja zamiast najnowszej stabilnej
`--channel beta`	kanał wydań
`-y`	bez zadawania pytań

Co się dzieje

Sprawdzenie maszyny: system, pamięć, dysk, inne panele.
Sprawdzenie klucza: znak kontrolny — lokalnie, potem zapytanie do serwera licencji. To zapytanie nie zajmuje licencji: przerwana instalacja niczego nie przypisuje.
Manifest wydania: lista plików i ich SHA-256, podpisana kluczem wydań. Publiczna połowa klucza jest wbudowana w skrypt instalacyjny — podmienionej kompilacji on nie zainstaluje.
Pobieranie ze wznawianiem i weryfikacją każdego pliku.
Instalacja z gotowej kompilacji: kompilator i npm nie są potrzebne na serwerze. Na koniec panel aktywuje klucz — od tej chwili licencja jest przypisana do serwera.

Dane dostępowe pierwszego administratora instalator wypisuje na końcu i zapisuje w /root/.ultrapanel-first-admin. Bez --domain panel otwiera się na porcie 9443.

Klucz i licencja na serwerze

ultrapanel-ctl license             # edycja, okres, ostatni kontakt
ultrapanel-ctl license set-key UPL-…  # zmień klucz
ultrapanel-ctl license refresh     # połącz się z serwerem licencji teraz
ultrapanel-ctl license release     # zwolnij licencję przed przeprowadzką

Panel łączy się z serwerem licencji co kilka godzin i trzyma podpisaną dzierżawę na 14 dni: krótka przerwa w łączności nie wpływa na jego pracę.

Przeprowadzka na inny serwer

Jeden klucz — jeden serwer. Aby zainstalować panel na nowej maszynie, odłącz starą na koncie licencji (lub uruchom na niej ultrapanel-ctl license release) albo uruchom instalację z --force-move. Jeśli stary serwer milczy dłużej niż trzy doby, licencja przejdzie sama. Najwyżej trzy przeniesienia w ciągu 30 dni.

Aktualizacja

ultrapanel-ctl upgrade

Nowa wersja przychodzi tą samą drogą co pierwsza: na podstawie klucza, ze sprawdzeniem podpisu. Strony nie zatrzymują się na czas aktualizacji.

Gdy licencja wygaśnie

Po dacie opłacenia trwa tydzień karencji. Potem blokowane jest tylko zarządzanie: nie można zakładać kont ani zmieniać ustawień. Strony, poczta, odnawianie certyfikatów, kopie zapasowe i przyjmowanie płatności od Twoich klientów działają dalej. Przedłużenie na koncie licencji zdejmuje blokadę przy następnym sprawdzeniu — albo od razu, przyciskiem „Sprawdź teraz” na ekranie „Licencja”.