--- title: Installa NexCMP description: Installa NexCMP su Ubuntu con il programma di installazione a riga singola: parametri, operazioni eseguite, TLS e nginx, e accesso alla procedura guidata. url: https://nexcmp.com/it/docs/getting-started/installation/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Installa NexCMP {#install-nexcmp} Il programma di installazione è uno script singolo fornito dal server di licenza. Verifica la macchina, attiva la tua licenza, scarica e verifica il programma, installa i servizi e (facoltativamente) configura nginx con un certificato Let's Encrypt. ## Prima di iniziare {#before-you-start} - Un server che soddisfi i [requirements](https://nexcmp.com/it/docs/getting-started/requirements/) e accesso root. - La tua **chiave di licenza** e il **dominio principale** dalla tua [license page](https://nexcmp.com/licenses) — vedi [License and purchase](https://nexcmp.com/it/docs/getting-started/license-and-purchase/). - Un record DNS per il dominio — vedi [DNS and Cloudflare](https://nexcmp.com/it/docs/getting-started/dns-and-cloudflare/). Puoi anche installare prima e correggere il DNS in un secondo momento; il programma di installazione indica cosa manca e può essere semplicemente eseguito di nuovo. ## Installa {#install} 1. Accedi al server e diventa root (o anteponi `sudo`). 2. Esegui il comando dalla tua pagina di licenza. Si presenta così: ```bash curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \ --license NXC-XXXXX-XXXXX-XXXXX-XXXXX \ --domain cloud.example.com \ --email admin@example.com ``` 3. Attendi i segni di spunta. Un'installazione pulita richiede pochi minuti; il primo avvio crea lo schema del database e può impiegare fino a un minuto su dischi lenti. 4. Leggi il riepilogo alla fine. Stampa gli URL del portale e dell'amministrazione, il **codice di configurazione** e il passaggio successivo. ![Il programma di installazione al termine con l'URL del portale, l'URL di amministrazione e il codice di configurazione monouso](https://nexcmp.com/it/docs/images/getting-started/installation-01-finish.webp) ## Parametri {#parameters} | Parametro | Predefinito | Significato | |---|---|---| | `--license KEY` | obbligatorio alla prima installazione | La chiave di licenza. | | `--domain NAME` | obbligatorio alla prima installazione | Dominio principale. Deve corrispondere alla licenza. `https://` e i percorsi finali vengono rimossi. | | `--email ADDRESS` | nessuno | E-mail di contatto per gli avvisi di scadenza di Let's Encrypt. Senza di essa il certificato viene registrato senza e-mail. | | `--port N` | `3000` | Porta locale del pannello (1–65535). | | `--no-nginx` | disattivo | Non installare o configurare nginx / TLS. Da usare quando gestisci il tuo proxy inverso o vuoi prima dare un'occhiata a NexCMP. | | `--behind-cloudflare` | rilevato automaticamente | Forza la modalità "il dominio è protetto da Cloudflare". Normalmente rilevata dal DNS. | | `--channel NAME` | `stable` | Canale di rilascio. | Eseguire nuovamente il programma di installazione **senza parametri** riutilizza quelli salvati (`/etc/nexcmp/install.conf`) ed effettua l'aggiornamento in sicurezza, mantenendo dati, configurazione e account. È esattamente ciò che fa `sudo nexcmp update`. ## Cosa fa il programma di installazione {#what-the-installer-does} 1. **Verifica la macchina** — Ubuntu 22.04/24.04, x86_64, almeno 2 GB di RAM, 8 GB di disco libero. 2. **Installa i pacchetti** necessari (`curl`, `zstd`, `openssl`, `python3`, `openssh-client`...). 3. **Crea l'utente di servizio** `nexcmp` e le directory: `/opt/nexcmp` (programma, di proprietà di root, di sola lettura per il servizio), `/etc/nexcmp` (configurazione), `/var/lib/nexcmp` (dati), `/var/log/nexcmp`. 4. **Attiva la licenza** per il dominio e memorizza un ID istanza fisso per questa macchina. 5. **Scarica l'ultima versione disponibile** a cui hai diritto, quindi ne verifica lo SHA-256 e la firma Ed25519. Una release priva di firma valida viene rifiutata. Non effettua mai il downgrade di una versione più recente in esecuzione. 6. **Scrive la configurazione e le unità systemd** (`nexcmp`, `nexcmp-vmd`, `nexcmp-update`) e avvia i servizi; attende la risposta di `/healthz`. 7. **Configura nginx e TLS** (tranne se `--no-nginx`): ottiene un certificato Let's Encrypt con certbot (sfida webroot) per il dominio e per `admin.` / `partner.` quando anche questi nomi si risolvono. Se il DNS non punta ancora a questo server (o a Cloudflare), salta questo passaggio e lo segnala. 8. **Stampa un riepilogo** con gli URL e, se non esiste ancora alcun amministratore, il **codice di configurazione**. ## La porta del pannello (3000) {#the-panel-port-3000} - Durante la prima installazione il pannello rimane in ascolto su `0.0.0.0:3000` per consentirti di aprire la procedura guidata di configurazione su `http://:3000/setup`. - Una volta completata la procedura guidata **e** attivato il TLS, il pannello rimane in ascolto solo su `127.0.0.1`; nginx vi esegue il proxy di `https://`. - Per le emergenze (nginx non funzionante, DNS errato) puoi aprire la porta per un periodo limitato: `sudo nexcmp open-port 30` (30 minuti, dopodiché si chiude automaticamente) — oppure utilizzare un tunnel SSH: `ssh -L 3000:127.0.0.1:3000 ` e navigare su `http://127.0.0.1:3000/`. ::: warning HTTP non crittografato La porta 3000 utilizza HTTP in chiaro. Usala solo per la procedura guidata di configurazione su una rete attendibile o tramite un tunnel SSH. Non lasciarla aperta. ::: ## Installazione senza un dominio pubblico (laboratorio o test) {#installing-without-a-public-domain-lab-or-test} Puoi eseguire l'installazione su una macchina che non dispone ancora di un DNS: ```bash curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \ --license NXC-XXXXX-XXXXX-XXXXX-XXXXX --domain lab.example.com --no-nginx ``` Quindi apri la procedura guidata tramite un tunnel SSH (`ssh -L 3000:127.0.0.1:3000 `, naviga su `http://127.0.0.1:3000/setup`). Esegui nuovamente l'installer senza `--no-nginx` non appena il DNS sarà configurato. ## Docker e Kubernetes {#docker-and-kubernetes} Non esiste un'immagine container pubblicata. L'installer (un'installazione nativa con systemd) è il metodo di installazione supportato. ## Verifica {#verify} ```bash sudo nexcmp status ``` Dovresti visualizzare la versione, `nexcmp: active`, `nexcmp-vmd: active`, `healthz: ok` e — fino al completamento della procedura guidata — il codice di configurazione. Prosegui con la [setup wizard](https://nexcmp.com/it/docs/getting-started/setup-wizard/). Se qualcosa non va, consulta [Installation errors](https://nexcmp.com/it/docs/troubleshooting/installation-errors/).