--- title: Erros de instalação description: Todas as mensagens de erro do instalador do NexCMP, causas e soluções: requisitos, ativação de licença, verificação de download, serviços e nginx/TLS. url: https://nexcmp.com/pt/docs/troubleshooting/installation-errors/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Erros de instalação {#installation-errors} O instalador para no primeiro problema fatal e exibe uma linha vermelha começando com `✗`. Corrija a causa e **execute o mesmo comando novamente** — o instalador pode ser repetido com segurança. Linhas informativas começam com `•`, etapas bem-sucedidas com `✓`. ## Verificações da máquina {#machine-checks} | Mensagem | Causa | Correção | |---|---|---| | `must be run as root (sudo)` | Não executando como root | Prefixe o comando com `sudo` ou execute como root. | | `only Ubuntu 22.04/24.04 is supported (this host: …)` | Outra distribuição ou versão | Use um servidor Ubuntu 22.04 ou 24.04. | | `only x86_64 is supported` | ARM ou outra CPU | Use um servidor x86_64. | | `requires ≥ 2 GB RAM (host has … MB)` | Pouca memória | Adicione RAM. | | `requires ≥ 8 GB free disk space on / (… GB available)` | Sistema de arquivos raiz quase cheio | Libere espaço ou aumente `/`. | | `missing --license` / `missing --domain` | Primeira instalação sem esses parâmetros | Passe ambos — veja [Installation](https://nexcmp.com/pt/docs/getting-started/installation/#parameters). | | `unknown argument: …` | Erro de digitação em um parâmetro | Verifique a ortografia; execute com `--help`. | | `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | O gerenciador de pacotes está bloqueado | Aguarde alguns minutos (uma instalação limpa do Ubuntu executa atualizações automáticas após a inicialização) e execute novamente. | | `… is a symlink — aborting` | `/opt/nexcmp` ou `/etc/nexcmp` é um link simbólico | Substitua-o por um diretório real — o instalador recusa links simbólicos por motivos de segurança. | ## Ativação de licença {#license-activation} | Mensagem | Causa | Correção | |---|---|---| | `cannot connect to https://nexcmp.com` | Sem HTTPS de saída para o servidor de licenças | Verifique o DNS, o firewall e o proxy no servidor: `curl -I https://nexcmp.com`. | | `license activation failed (HTTP …): ` | O servidor de licenças rejeitou a chave | Leia a mensagem: chave incorreta, domínio incompatível com a licença, licença suspensa ou revogada. Verifique a página de licenças em [nexcmp.com/licenses](https://nexcmp.com/licenses). | | `no release available for this license yet` | A licença não possui uma versão para download | Entre em contato com as vendas; consulte [Support](https://nexcmp.com/pt/docs/troubleshooting/support/). | ## Download e verificação {#download-and-verification} | Mensagem | Causa | Correção | |---|---|---| | `failed to download release X` | Problema de rede durante o download | Execute novamente. | | `sha256 mismatch (… ≠ …)` | O arquivo chegou danificado ou foi alterado | Execute novamente; se o problema persistir, um proxy pode estar reescrevendo os downloads — tente a partir de outra rede. | | `release X is unsigned — refusing to install` | O servidor não forneceu nenhuma assinatura | Nunca ignore; entre em contato com o suporte. | | `INVALID SIGNATURE for version X — aborting` | A assinatura Ed25519 não pôde ser verificada | Não **instale**. Entre em contato com o suporte — isso significa que o arquivo não é uma versão oficial. | | `openssl failed to read public key` | OpenSSL muito antigo ou corrompido | Atualize o pacote `openssl`. | | `invalid version: …` | Dados inesperados do servidor | Execute novamente; entre em contato com o suporte se o problema persistir. | ## Inicialização do serviço {#service-start} | Mensagem | Causa | Correção | |---|---|---| | `service failed to start — check: journalctl -u nexcmp -n 50` | O painel não respondeu a `/healthz` dentro de 3 minutos | Leia o journal. Causas comuns: a porta (padrão 3000) já está em uso (`ss -ltnp | grep 3000`) — reinstale com `--port`; arquivos pertencentes ao usuário root em `/var/lib/nexcmp` — execute `sudo nexcmp fix-owner`. | ## nginx e TLS {#nginx-and-tls} | Mensagem | Causa | Correção | |---|---|---| | `DNS does not point to (nor to Cloudflare) — skipping nginx/TLS` | O registro A/AAAA está ausente ou incorreto | Consulte [DNS and Cloudflare](https://nexcmp.com/pt/docs/getting-started/dns-and-cloudflare/) e execute novamente. | | `certbot could not get a certificate yet — re-run the installer once DNS has settled` | A validação do Let's Encrypt falhou (porta 80 bloqueada, DNS não propagado, limite de taxa) | Abra a porta 80, aguarde a propagação do DNS e execute novamente. Verifique `/var/log/letsencrypt/letsencrypt.log`. | | `certbot could not renew now — keeping the existing certificate` | Falha temporária na renovação | Inofensivo; execute novamente mais tarde. | | `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | Outro site do nginx entra em conflito (mesmo `server_name`, configurações duplicadas) | Execute `sudo nginx -t` e corrija o conflito, depois execute novamente. | | `apt-get could not install nginx` / `certbot`, ou `E: Failed to fetch … 404 Not Found` | Gerenciador de pacotes bloqueado ou índice de pacotes do servidor desatualizado (comum em imagens de modelo que não são atualizadas há algum tempo) | Execute `sudo apt-get update`, aguarde a conclusão de qualquer outro processo apt e execute o instalador novamente. | | `openssl could not create the self-signed certificate` | Problema no OpenSSL | Atualize `openssl`; execute novamente. | ## Após a instalação {#after-installation} | Sintoma | Causa | Correção | |---|---|---| | O navegador não consegue abrir `https://` | DNS ou TLS não prontos | `sudo nexcmp status`; use o [acesso de emergência](https://nexcmp.com/pt/docs/getting-started/cli-reference/#emergency-access). | | `ERR_TOO_MANY_REDIRECTS` | Modo SSL do Cloudflare **Flexible** | Defina **Full (strict)** — [details](https://nexcmp.com/pt/docs/getting-started/dns-and-cloudflare/). | | O assistente diz que o "setup code" está incorreto | Erro de digitação ou um código de uma instalação anterior | Execute `sudo nexcmp status` e copie o código atual. | | A licença exibe HTTP 421 | Arquivos em `/var/lib/nexcmp` pertencem ao root | `sudo nexcmp fix-owner`, depois `sudo systemctl restart nexcmp`. |