Installation
Ein Befehl auf einem frischen Server: Das Skript prüft Maschine und Schlüssel, lädt ein signiertes Release herunter und installiert das Panel.
Voraussetzungen
- Ubuntu 22.04, 24.04, 26.04 oder Debian 12, 13, x86_64, systemd, root-Zugang.
- Mindestens 512 MB Arbeitsspeicher und 8 GB frei auf
/. Auf einer kleinen Maschine legt der Installer eine Swap-Datei an und stellt PostgreSQL sparsamer ein. - Ein frischer Server: Ist bereits ISPmanager, Plesk, cPanel, CyberPanel, aaPanel, Hestia, Vesta oder DirectAdmin installiert, bricht die Installation ab.
- Ausgehendes HTTPS zum Lizenzserver. Eingehende Ports 80 und 443 für Websites und Zertifikate.
- Für MicroVMs (Tier M und F in Pro und Host) —
/dev/kvm. Ohne laufen nur Container mit Tier S.
Der Befehl
Der Aktivierungsschlüssel kommt nach dem Kauf oder dem Start der Testphase per E-Mail und steht auch in Ihrem Lizenzkonto. Als root:
bash <(curl -fsSL https://getultrapanel.com/install.sh) --key UPL-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
Ohne --key fragt das Skript nach dem Schlüssel. Nützliche Optionen:
| Option | Wirkung |
|---|---|
--domain panel.example.com | Hostname des Panels; das Panel erhält sofort ein Zertifikat von Let's Encrypt |
--email [email protected] | Login des ersten Administrators und Kontakt für die Zertifizierungsstelle; fehlt die Angabe, fragt das Skript nach |
--zfs-disk /dev/sdb | eigene Festplatte für die Kontodaten. Ohne sie wird ein Pool in einer Sparse-Datei mit 24 GB angelegt — für einen Test ausreichend |
--force-move | der Schlüssel läuft bereits auf einem anderen Server — die Lizenz hierher übernehmen |
--version 1.2.0 | eine bestimmte Version statt der neuesten stabilen |
--channel beta | Release-Kanal |
-y | keine Rückfragen |
Was passiert
- Prüfung der Maschine: Betriebssystem, Arbeitsspeicher, Festplatte, andere Panels.
- Prüfung des Schlüssels: zuerst lokal das Prüfzeichen, dann eine Anfrage an den Lizenzserver. Diese Anfrage belegt die Lizenz nicht: Eine abgebrochene Installation bindet nichts.
- Release-Manifest: Dateiliste und SHA-256-Summen, signiert mit dem Release-Schlüssel. Dessen öffentlicher Teil ist in das Skript eingebaut — ein manipuliertes Release installiert es nicht.
- Download mit Fortsetzung bei Abbruch und Prüfung jeder Datei.
- Installation aus dem fertigen Paket: Compiler und npm sind auf dem Server nicht nötig. Zum Schluss aktiviert das Panel den Schlüssel — ab dann ist die Lizenz an diesen Server gebunden.
Die Zugangsdaten des ersten Administrators gibt der Installer am Ende aus und speichert sie in /root/.ultrapanel-first-admin. Ohne --domain ist das Panel auf Port 9443 erreichbar.
Schlüssel und Lizenz auf dem Server
ultrapanel-ctl license # Edition, Laufzeit, letzter Kontakt ultrapanel-ctl license set-key UPL-… # Schlüssel ändern ultrapanel-ctl license refresh # Lizenzserver sofort kontaktieren ultrapanel-ctl license release # Lizenz vor dem Umzug freigeben
Das Panel meldet sich alle paar Stunden beim Lizenzserver und hält eine signierte Lease für 14 Tage: Ein kurzer Verbindungsausfall wirkt sich nicht aus.
Umzug auf einen anderen Server
Ein Schlüssel, ein Server. Um das Panel auf einer neuen Maschine zu installieren, trennen Sie die alte im Lizenzkonto (oder führen Sie dort ultrapanel-ctl license release aus) oder installieren Sie mit --force-move. Meldet sich der alte Server länger als drei Tage nicht, wechselt die Lizenz von selbst. Höchstens drei Übernahmen in 30 Tagen.
Updates
ultrapanel-ctl upgrade
Eine neue Version kommt auf demselben Weg wie die erste: über den Schlüssel, mit Prüfung der Signatur. Websites laufen während des Updates weiter.
Wenn die Lizenz abläuft
Nach dem Ende des bezahlten Zeitraums folgt eine Kulanzwoche. Danach wird nur die Verwaltung gesperrt: keine neuen Konten, keine Änderungen an Einstellungen. Websites, E-Mail, Zertifikatsverlängerung, Backups und Zahlungen Ihrer Kunden laufen weiter. Eine Verlängerung im Lizenzkonto hebt die Sperre bei der nächsten Prüfung auf — oder sofort mit „Jetzt prüfen“ auf dem Bildschirm „Lizenz“.