---
title: Erreurs d'installation
description: Consultez tous les messages d'erreur de l'installateur NexCMP, leurs causes et solutions : prérequis, licence, téléchargement, services et nginx/TLS.
url: https://nexcmp.com/fr/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Erreurs d'installation {#installation-errors}

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 {#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](https://nexcmp.com/fr/docs/getting-started/installation/#parameters). |
| `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 {#license-activation}

| 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](https://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](https://nexcmp.com/fr/docs/troubleshooting/support/). |

## Téléchargement et vérification {#download-and-verification}

| 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 {#service-start}

| 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 | grep 3000`) — réinstallez avec `--port` ; fichiers appartenant à root dans `/var/lib/nexcmp` — exécutez `sudo nexcmp fix-owner`. |

## nginx et TLS {#nginx-and-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](https://nexcmp.com/fr/docs/getting-started/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 {#after-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](https://nexcmp.com/fr/docs/getting-started/cli-reference/#emergency-access). |
| `ERR_TOO_MANY_REDIRECTS` | Mode SSL Cloudflare **Flexible** | Définir sur **Full (strict)** — [détails](https://nexcmp.com/fr/docs/getting-started/dns-and-cloudflare/). |
| 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`. |