Erreurs d'installation
L'installateur s'arrête au premier problème critique et affiche une ligne rouge commençant par ✗. Corrigez la cause et exécutez à nouveau la même commande — l'installateur peut être relancé sans risque. Les lignes d'information commencent par •, les étapes réussies par ✓.
Machine checks
| Message | Cause | Solution |
|---|---|---|
must be run as root (sudo) | Exécution sans les privilèges root | Faites précéder la commande par sudo ou exécutez-la en tant que root. |
only Ubuntu 22.04/24.04 is supported (this host: …) | Autre distribution ou version | Use an Ubuntu 22.04 or 24.04 server. |
only x86_64 is supported | ARM or other CPU | Use an x86_64 server. |
requires ≥ 2 GB RAM (host has … MB) | Too little memory | Add RAM. |
requires ≥ 8 GB free disk space on / (… GB available) | Système de fichiers root presque saturé | Libérez de l'espace ou agrandissez /. |
missing --license / missing --domain | Première installation sans ces paramètres | Transmettez les deux — voir Installation. |
unknown argument: … | Typo in a parameter | Vérifiez l'orthographe ; exécutez avec --help. |
apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running) | Le gestionnaire de paquets est verrouillé | Patientez quelques minutes (un Ubuntu frais exécute des mises à jour automatiques après le démarrage) et relancez. |
… is a symlink — aborting | /opt/nexcmp ou /etc/nexcmp est un lien symbolique | Remplacez-le par un vrai répertoire — le programme d'installation refuse les liens symboliques pour des raisons de sécurité. |
Activation de la licence
| Message | Cause | Solution |
|---|---|---|
cannot connect to https://nexcmp.com | Pas de trafic HTTPS sortant vers le serveur de licence | Vérifiez le DNS, le pare-feu et le proxy sur le serveur : curl -I https://nexcmp.com. |
license activation failed (HTTP …): <message> | Le serveur de licence a rejeté la clé | Lisez le message : clé erronée, domaine ne correspondant pas à la licence, licence suspendue ou révoquée. Consultez la page de licence sur nexcmp.com/licenses. |
no release available for this license yet | La licence ne comporte aucune version téléchargeable | Contactez le service commercial ; consultez Support. |
Téléchargement et vérification
| Message | Cause | Solution |
|---|---|---|
failed to download release X | Problème réseau pendant le téléchargement | Relancez. |
sha256 mismatch (… ≠ …) | Le fichier est arrivé endommagé ou a été altéré | Relancez ; si cela se reproduit, un proxy réécrit peut-être les téléchargements — essayez depuis un autre réseau. |
release X is unsigned — refusing to install | Le serveur n'a fourni aucune signature | Ne contournez jamais ; contactez le support. |
INVALID SIGNATURE for version X — aborting | La signature Ed25519 ne peut pas être vérifiée | N'installez pas. Contactez le support — cela signifie que le fichier n'est pas une version officielle. |
openssl failed to read public key | OpenSSL très ancien ou endommagé | Mettez à jour le paquet openssl. |
invalid version: … | Données inattendues provenant du serveur | Relancez ; contactez le support si le problème persiste. |
Démarrage du service
| Message | Cause | Solution |
|---|---|---|
service failed to start — check: journalctl -u nexcmp -n 50 | Le panneau n'a pas répondu à /healthz dans un délai de 3 minutes | Lisez le journal. Causes courantes : le port (par défaut 3000) est déjà utilisé (`ss -ltnp |
nginx et TLS
| Message | Cause | Solution |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | L'enregistrement A/AAAA est absent ou erroné | Consultez DNS and Cloudflare, puis relancez. |
certbot could not get a certificate yet — re-run the installer once DNS has settled | La validation Let's Encrypt a échoué (port 80 bloqué, DNS non propagé, limite de taux) | Ouvrez le port 80, attendez la propagation du DNS, relancez. Vérifiez /var/log/letsencrypt/letsencrypt.log. |
certbot could not renew now — keeping the existing certificate | Échec temporaire de renouvellement | Sans conséquence ; relancez plus tard. |
nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t) | Conflit avec un autre site nginx (même server_name, paramètres en double) | Exécutez sudo nginx -t et corrigez le conflit, puis relancez. |
apt-get could not install nginx / certbot, ou E: Failed to fetch … 404 Not Found | Gestionnaire de paquets verrouillé ou index des paquets du serveur obsolète (typique sur une image de modèle qui n'a pas été mise à jour depuis un moment) | Exécutez sudo apt-get update, attendez la fin de tout autre processus apt, puis relancez le programme d'installation. |
openssl could not create the self-signed certificate | Problème OpenSSL | Mettez à jour openssl ; relancez. |
Après l'installation
| Symptôme | Cause | Solution |
|---|---|---|
Le navigateur ne parvient pas à ouvrir https://<domain> | DNS ou TLS non prêt | sudo nexcmp status ; utilisez l'emergency access. |
ERR_TOO_MANY_REDIRECTS | Mode SSL Cloudflare Flexible | Définir sur Full (strict) — détails. |
| L'assistant indique que le code de configuration est erroné | Faute de frappe ou code issu d'une installation précédente | Exécutez sudo nexcmp status et copiez le code actuel. |
| La licence affiche HTTP 421 | Fichiers dans /var/lib/nexcmp détenus par root | sudo nexcmp fix-owner, puis sudo systemctl restart nexcmp. |