Errori di installazione
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
| 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. |
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
| 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 …): <message> | 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. |
no release available for this license yet | La licenza non ha alcuna release scaricabile | Contatta l'ufficio vendite; consulta Support. |
Download e verifica
| 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
| 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 |
nginx e TLS
| Messaggio | Causa | Soluzione |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | Il record A/AAAA è mancante o errato | Consulta 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
| Sintomo | Causa | Soluzione |
|---|---|---|
Il browser non riesce ad aprire https://<domain> | DNS o TLS non pronti | sudo nexcmp status; usa emergency access. |
ERR_TOO_MANY_REDIRECTS | Modalità SSL di Cloudflare Flexible | Imposta su Full (strict) — dettagli. |
| 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. |