Installation

Une commande sur un serveur vierge : le script d’amorçage vérifie la machine et la clé, télécharge une version signée et installe le panneau.

Prérequis

Ubuntu 22.04, 24.04, 26.04 ou Debian 12, 13, x86_64, systemd, accès root.
Au moins 512 Mo de mémoire et 8 Go libres sur /. Sur une petite machine, l’installateur ajoute un fichier d’échange et allège la configuration de PostgreSQL.
Un serveur vierge : si ISPmanager, Plesk, cPanel, CyberPanel, aaPanel, Hestia, Vesta ou DirectAdmin y est déjà installé, l’installation s’arrête.
HTTPS sortant vers le serveur de licences. Ports entrants 80 et 443 pour les sites et les certificats.
Pour les micro-VM (Tier M et F dans Pro et Host) : /dev/kvm. Sans lui, seuls les conteneurs Tier S fonctionnent.

La commande

La clé d’activation arrive par e-mail après un achat ou le lancement d’un essai ; elle figure aussi dans votre espace licences. En root :

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

Sans --key, le script d’amorçage demande la clé. Options utiles :

Option	Effet
`--domain panel.example.com`	nom d’hôte du panneau ; le panneau obtient aussitôt un certificat Let's Encrypt
`--email [email protected]`	identifiant du premier administrateur et contact pour l’autorité de certification ; demandé s’il manque
`--zfs-disk /dev/sdb`	un disque dédié aux données des comptes. Sans lui, un pool de 24 Go sur fichier creux est utilisé : suffisant pour un essai
`--force-move`	la clé fonctionne déjà sur un autre serveur : transférer la licence ici
`--version 1.2.0`	une version précise au lieu de la dernière version stable
`--channel beta`	canal de publication
`-y`	sans poser de questions

Déroulement

Vérification de la machine : système, mémoire, disque, autres panneaux.
Vérification de la clé : le caractère de contrôle en local, puis une requête au serveur de licences. Cette requête n’occupe pas la licence : une installation interrompue ne lie rien.
Manifeste de version : liste des fichiers et sommes SHA-256, signés avec la clé de publication. Sa moitié publique est intégrée au script d’amorçage, qui refuse donc une version falsifiée.
Téléchargement avec reprise et vérification de chaque fichier.
Installation depuis la version précompilée : ni compilateur ni npm sur le serveur. À la fin, le panneau active la clé ; dès lors, la licence est liée à ce serveur.

Les identifiants du premier administrateur sont affichés à la fin et enregistrés dans /root/.ultrapanel-first-admin. Sans --domain, le panneau écoute sur le port 9443.

Clé et licence sur le serveur

ultrapanel-ctl license             # édition, échéance, dernier contact
ultrapanel-ctl license set-key UPL-…  # changer de clé
ultrapanel-ctl license refresh     # contacter le serveur de licences maintenant
ultrapanel-ctl license release     # libérer la licence avant un transfert

Le panneau contacte le serveur de licences toutes les quelques heures et conserve un bail signé valable 14 jours : une courte coupure est sans effet.

Transfert vers un autre serveur

Une clé, un serveur. Pour installer sur une nouvelle machine, dissociez l’ancienne dans votre espace licences (ou lancez ultrapanel-ctl license release sur celle-ci), ou bien installez avec --force-move. Si l’ancien serveur est muet depuis plus de trois jours, la licence est transférée d’elle-même. Trois transferts au plus sur 30 jours.

Mises à jour

ultrapanel-ctl upgrade

Une nouvelle version arrive par le même chemin que la première : par la clé, avec vérification de la signature. Les sites continuent de fonctionner pendant la mise à jour.

À l’expiration de la licence

Une semaine de grâce suit la date de fin de paiement. Ensuite, seule la gestion est verrouillée : plus de nouveaux comptes ni de modification des réglages. Les sites, la messagerie, le renouvellement des certificats, les sauvegardes et les paiements de vos propres clients continuent de fonctionner. Un renouvellement dans votre espace licences lève le verrou au contact suivant, ou immédiatement avec le bouton « Vérifier maintenant » de l’écran « Licence ».