---
title: Referência de comandos do nexcmp
description: Todos os subcomandos da ferramenta de linha de comando nexcmp server — status, update, backup, uninstall, open-port, close-port e fix-owner.
url: https://nexcmp.com/pt/docs/getting-started/cli-reference/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Referência de comando `nexcmp` {#nexcmp-command-reference}

O instalador coloca um auxiliar em `/usr/local/bin/nexcmp`. Execute-o no servidor NexCMP. Comandos que alteram o sistema precisam de `sudo`. (A ferramenta voltada ao cliente para a API é um programa diferente, consulte [cmp CLI](https://nexcmp.com/pt/docs/developers/cmp-cli/).)

| Comando | Requer root | O que faz |
|---|---|---|
| `nexcmp status` | Não (mais detalhes com `sudo`) | Versão, estado do serviço (`nexcmp`, `nexcmp-vmd`), `/healthz`, resumo da licença, estado da porta pública, código de instalação se o assistente não estiver concluído |
| `nexcmp update` | Sim | Executa o instalador fornecido na versão instalada com os parâmetros salvos — consulte [Atualizando](https://nexcmp.com/pt/docs/getting-started/updating/) |
| `nexcmp backup [dir]` | Sim | Backup para `/var/backups/nexcmp` (ou `dir`) — consulte [Backup and restore](https://nexcmp.com/pt/docs/getting-started/backup-and-restore/) |
| `nexcmp uninstall [--purge]` | Sim | Remover serviços e programa; `--purge` também remove os dados — consulte [Uninstall](https://nexcmp.com/pt/docs/getting-started/uninstall/) |
| `nexcmp open-port [minutes]` | Sim | **Emergência**: escutar na porta do painel (padrão 3000) em todas as interfaces por 1 a 1440 minutos (padrão 30) e, em seguida, fechar automaticamente |
| `nexcmp close-port` | Sim | Fechar a janela de emergência agora |
| `nexcmp fix-owner` | Sim | Devolver os arquivos em `/var/lib/nexcmp` pertencentes ao root para o usuário `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 os arquivos no diretório de dados pertencerem ao root (por exemplo, criados ao executar outro comando do `nexcmp` com `sudo` como root), o `status` exibirá um aviso, pois o usuário do serviço não consegue lê-los — um sintoma típico é a licença exibindo HTTP 421. Corrija com `sudo nexcmp fix-owner`. A mesma correção é executada automaticamente a cada inicialização do serviço.

## Acesso de emergência {#emergency-access}

Quando o domínio, o nginx ou o TLS estiverem com problemas, você ainda poderá acessar o painel:

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

Mais seguro, sem abrir nada: `ssh -L 3000:127.0.0.1:3000 user@server` e acesse `http://127.0.0.1:3000/`.

## Ambiente {#environment}

| Variável | Usado para |
|---|---|
| `NEXCMP_BASE` | Substituir a URL base do servidor de licenças (padrão `https://nexcmp.com`); apenas para testes |

Arquivos e diretórios: programa `/opt/nexcmp`, configuração `/etc/nexcmp`, dados `/var/lib/nexcmp`, logs `/var/log/nexcmp` e `journalctl -u nexcmp -u nexcmp-vmd`.