--- title: Errori di installazione description: Tutti i messaggi di errore dell'installatore NexCMP, cause e soluzioni: requisiti, licenza, verifica download, servizi e nginx/TLS. url: https://nexcmp.com/it/docs/troubleshooting/installation-errors/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Errori di installazione {#installation-errors} L'installatore si ferma al primo problema bloccante e stampa una riga rossa che inizia con `✗`. Risolvi la causa ed **esegui nuovamente lo stesso comando**; l'installatore può essere ripetuto in sicurezza. Le righe informative iniziano con `•`, i passaggi riusciti con `✓`. ## Controlli della macchina {#machine-checks} | Messaggio | Causa | Soluzione | |---|---|---| | `must be run as root (sudo)` | Esecuzione non come root | Anticipa il comando con `sudo` oppure esegui come root. | | `only Ubuntu 22.04/24.04 is supported (this host: …)` | Altra distribuzione o versione | Utilizza un server Ubuntu 22.04 o 24.04. | | `only x86_64 is supported` | ARM o altra CPU | Utilizza un server x86_64. | | `requires ≥ 2 GB RAM (host has … MB)` | Memoria insufficiente | Aggiungi RAM. | | `requires ≥ 8 GB free disk space on / (… GB available)` | File system root quasi pieno | Libera spazio o espandi `/`. | | `missing --license` / `missing --domain` | Prima installazione senza questi parametri | Passa entrambi — vedi [Installation](https://nexcmp.com/it/docs/getting-started/installation/#parameters). | | `unknown argument: …` | Errore di digitazione in un parametro | Verifica l'ortografia; esegui con `--help`. | | `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | Il gestore pacchetti è bloccato | Attendi qualche minuto (un'Ubuntu appena installata esegue gli aggiornamenti automatici dopo il boot) e riavvia. | | `… is a symlink — aborting` | `/opt/nexcmp` o `/etc/nexcmp` è un collegamento simbolico | Sostituiscilo con una directory reale; per motivi di sicurezza, il programma di installazione rifiuta i link simbolici. | ## Attivazione della licenza {#license-activation} | Messaggio | Causa | Soluzione | |---|---|---| | `cannot connect to https://nexcmp.com` | Nessuna connessione HTTPS in uscita verso il server di licenza | Verifica DNS, firewall e proxy sul server: `curl -I https://nexcmp.com`. | | `license activation failed (HTTP …): ` | Il server di licenza ha rifiutato la chiave | Leggi il messaggio: chiave errata, dominio non corrispondente alla licenza, licenza sospesa o revocata. Controlla la pagina della licenza su [nexcmp.com/licenses](https://nexcmp.com/licenses). | | `no release available for this license yet` | La licenza non ha alcuna release scaricabile | Contatta l'ufficio vendite; consulta [Support](https://nexcmp.com/it/docs/troubleshooting/support/). | ## Download e verifica {#download-and-verification} | Messaggio | Causa | Soluzione | |---|---|---| | `failed to download release X` | Problema di rete durante il download | Riavvia. | | `sha256 mismatch (… ≠ …)` | Il file è arrivato danneggiato o è stato alterato | Riavvia; se il problema persiste, un proxy potrebbe alterare i download — prova da un'altra rete. | | `release X is unsigned — refusing to install` | Il server non ha fornito alcuna firma | Non ignorarla mai; contatta il supporto. | | `INVALID SIGNATURE for version X — aborting` | La firma Ed25519 non è verificabile | Non installare **mai**. Contatta il supporto: significa che il file non è una release ufficiale. | | `openssl failed to read public key` | OpenSSL molto vecchio o danneggiato | Aggiorna il pacchetto `openssl`. | | `invalid version: …` | Dati inattesi dal server | Riavvia; contatta il supporto se il problema persiste. | ## Avvio del servizio {#service-start} | Messaggio | Causa | Soluzione | |---|---|---| | `service failed to start — check: journalctl -u nexcmp -n 50` | Il pannello non ha risposto a `/healthz` entro 3 minuti | Leggi il journal. Cause comuni: la porta (predefinita 3000) è già in uso (`ss -ltnp | grep 3000`) — re-installa con `--port`; file di proprietà di root in `/var/lib/nexcmp` — esegui `sudo nexcmp fix-owner`. | ## nginx e TLS {#nginx-and-tls} | Messaggio | Causa | Soluzione | |---|---|---| | `DNS does not point to (nor to Cloudflare) — skipping nginx/TLS` | Il record A/AAAA è mancante o errato | Consulta [DNS and Cloudflare](https://nexcmp.com/it/docs/getting-started/dns-and-cloudflare/), quindi riavvia. | | `certbot could not get a certificate yet — re-run the installer once DNS has settled` | Validazione Let's Encrypt non riuscita (porta 80 bloccata, DNS non propagato, limite di richieste) | Apri la porta 80, attendi la propagazione del DNS e riavvia. Controlla `/var/log/letsencrypt/letsencrypt.log`. | | `certbot could not renew now — keeping the existing certificate` | Errore di rinnovo temporaneo | Ininfluente; riavvia più tardi. | | `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | Conflitto con un altro sito nginx (stesso `server_name`, impostazioni duplicate) | Esegui `sudo nginx -t` e risolvi il conflitto, quindi riavvia. | | `apt-get could not install nginx` / `certbot` oppure `E: Failed to fetch … 404 Not Found` | Package manager bloccato o indice dei pacchetti del server non aggiornato (tipico di un'immagine di un template non aggiornata da tempo) | Esegui `sudo apt-get update`, attendi il completamento di eventuali altri processi apt, quindi riavvia l'installazione. | | `openssl could not create the self-signed certificate` | Problema con OpenSSL | Aggiorna `openssl` e riavvia. | ## Dopo l'installazione {#after-installation} | Sintomo | Causa | Soluzione | |---|---|---| | Il browser non riesce ad aprire `https://` | DNS o TLS non pronti | `sudo nexcmp status`; usa [emergency access](https://nexcmp.com/it/docs/getting-started/cli-reference/#emergency-access). | | `ERR_TOO_MANY_REDIRECTS` | Modalità SSL di Cloudflare **Flexible** | Imposta su **Full (strict)** — [dettagli](https://nexcmp.com/it/docs/getting-started/dns-and-cloudflare/). | | Il wizard indica che il codice di configurazione non è corretto | Errore di battitura o codice di un'installazione precedente | Esegui `sudo nexcmp status` e copia il codice corrente. | | La licenza restituisce HTTP 421 | File in `/var/lib/nexcmp` di proprietà di root | `sudo nexcmp fix-owner`, poi `sudo systemctl restart nexcmp`. |