Erros de instalação
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
| 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. |
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
| 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 …): <message> | 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. |
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. |
Download e verificação
| 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
| 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 |
nginx e TLS
| Mensagem | Causa | Correção |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | O registro A/AAAA está ausente ou incorreto | Consulte 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
| Sintoma | Causa | Correção |
|---|---|---|
O navegador não consegue abrir https://<domain> | DNS ou TLS não prontos | sudo nexcmp status; use o acesso de emergência. |
ERR_TOO_MANY_REDIRECTS | Modo SSL do Cloudflare Flexible | Defina Full (strict) — details. |
| 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. |