---
title: Riferimento comandi nexcmp
description: Tutti i sottocomandi dello strumento CLI per server nexcmp: status, update, backup, uninstall, open-port, close-port e fix-owner.
url: https://nexcmp.com/it/docs/getting-started/cli-reference/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Riferimento comandi `nexcmp` {#nexcmp-command-reference}

L'installer posiziona un helper in `/usr/local/bin/nexcmp`. Eseguilo sul server NexCMP. I comandi che modificano il sistema richiedono `sudo`. (Lo strumento lato cliente per le API è un programma differente, vedi [cmp CLI](https://nexcmp.com/it/docs/developers/cmp-cli/).)

| Comando | Richiede root | Descrizione |
|---|---|---|
| `nexcmp status` | No (maggiori dettagli con `sudo`) | Versione, stato dei servizi (`nexcmp`, `nexcmp-vmd`), `/healthz`, riepilogo licenza, stato porte pubbliche, codice di configurazione se la procedura guidata non è terminata |
| `nexcmp update` | Sì | Esegue l'installer incluso nella release installata con i parametri salvati — vedi [Aggiornamento](https://nexcmp.com/it/docs/getting-started/updating/) |
| `nexcmp backup [dir]` | Sì | Backup su `/var/backups/nexcmp` (o `dir`) — vedi [Backup and restore](https://nexcmp.com/it/docs/getting-started/backup-and-restore/) |
| `nexcmp uninstall [--purge]` | Sì | Rimuove servizi e programma; `--purge` rimuove anche i dati — vedi [Uninstall](https://nexcmp.com/it/docs/getting-started/uninstall/) |
| `nexcmp open-port [minutes]` | Sì | **Emergency**: resta in ascolto sulla porta del pannello (predefinita 3000) su tutte le interfacce per 1–1440 minuti (predefinito 30), quindi si chiude automaticamente |
| `nexcmp close-port` | Sì | Chiudi subito la finestra di emergenza |
| `nexcmp fix-owner` | Sì | Ripristina la proprietà dei file in `/var/lib/nexcmp` appartenenti a root assegnandoli all'utente `nexcmp` |

## `nexcmp status`

```text
Version   : 1.6.1
nexcmp     : active
nexcmp-vmd : active
healthz    : ok
License   : active · domain cloud.example.com · token valid until 2026-11-12 · updates until 2027-10-30
Public port: 127.0.0.1 only (nginx proxy; emergency: sudo nexcmp open-port)
```

Se i file nella directory dei dati appartengono a root (ad esempio perché creati eseguendo un altro comando `nexcmp` con `sudo` come root), `status` stampa un avviso poiché l'utente del servizio non può leggerli; un sintomo tipico è la licenza che restituisce HTTP 421. Risolvi con `sudo nexcmp fix-owner`. La stessa correzione viene eseguita automaticamente a ogni avvio del servizio.

## Accesso di emergenza {#emergency-access}

Quando il dominio, nginx o TLS non funzionano, puoi comunque raggiungere il pannello:

```bash
sudo nexcmp open-port 30          # http://<server-IP>:3000/ for 30 minutes
sudo nexcmp close-port            # close it earlier
```

Più sicuro, senza aprire nulla: `ssh -L 3000:127.0.0.1:3000 user@server` e visita `http://127.0.0.1:3000/`.

## Ambiente {#environment}

| Variabile | Utilizzato per |
|---|---|
| `NEXCMP_BASE` | Sovrascrive l'URL di base del server delle licenze (predefinito `https://nexcmp.com`); solo per test |

File e directory: programma `/opt/nexcmp`, configurazione `/etc/nexcmp`, dati `/var/lib/nexcmp`, log `/var/log/nexcmp` e `journalctl -u nexcmp -u nexcmp-vmd`.