Problemas de instalação e inicialização

Vá pela seção que corresponde ao que você está vendo. Cada lista está ordenada da solução mais provável para a menos provável.

O instalador não roda ou não termina.

  1. Confirme que seu sistema atende aos requisitos: Windows 10 de 64 bits (versão 2004) ou mais recente, um Mac com Apple Silicon, ou uma distribuição Linux x86-64 popular baseada em glibc com systemd. ARM64 e distribuições baseadas em musl não são suportadas. Veja Requisitos de sistema.
  2. No Windows, o Nexus-Setup.exe instala para a máquina inteira e precisa de direitos de administrador; aceite a única solicitação do UAC que ele mostra. Se nenhuma solicitação aparecer, clique com o botão direito no instalador e execute-o como administrador.
  3. No Linux, o install.sh precisa de sudo; execute-o a partir do diretório do tarball extraído.
  4. Se o instalador falhar no meio ou o arquivo parecer danificado, baixe-o de novo na página de download e execute-o outra vez. O passo a passo completo está em Instalando o Nexus.

Seu antivírus bloqueou ou removeu o Nexus.

Isso é um falso positivo. Restaure o arquivo da quarentena e libere a pasta do Nexus; os passos para cada antivírus estão em Antivírus e falsos positivos.

O Nexus está instalado, mas parece não estar rodando.

O Nexus roda como um serviço em segundo plano, com o app do painel por cima dele. Confira o serviço primeiro:

  1. Windows: abra os Serviços (services.msc) e procure Nexus Service. O tipo de inicialização dele é Automático; se estiver parado, inicie-o. Se ele não existir, execute o instalador de novo.
  2. macOS: abra o Nexus de novo pelo Finder. Com Iniciar o Nexus na inicialização do sistema ativado nas Configurações, o Nexus registra um launch agent (com.hellonexus.panel.service em ~/Library/LaunchAgents) que o inicia no login.
  3. Linux: execute systemctl status nexus. Reinicie-o com sudo systemctl restart nexus e leia a saída dele com journalctl -u nexus -f. Se você instalou antes de fazer login pela primeira vez, execute sudo systemctl restart nexus uma vez para o serviço adotar a sua sessão de login.
  4. Se o serviço iniciar e parar em seguida, colete os arquivos de log antes de tentar de novo, para que a falha fique registrada: veja Logs e como reportar um bug.

O serviço roda, mas o painel não abre.

  1. Abra http://localhost:9400 em um navegador no mesmo PC. O painel só é servido para a máquina em que o Nexus roda, então isso funciona localmente e em nenhum outro lugar. Se o painel carregar ali, o serviço está saudável e o problema é só a janela do app.
  2. No Windows, clique com o botão direito no ícone do Nexus na bandeja e escolha Open (Abrir), ou abra o Nexus pelo Menu Iniciar.
  3. Se a verificação pelo navegador também falhar, reinicie o serviço (veja a seção acima) e tente de novo.
  4. Ainda travado? Reinicie o PC, depois pegue os logs e reporte: Logs e como reportar um bug.

Dica

O https://my.hellonexus.com abre o mesmo painel pelo navegador, conectando-se ao Nexus no computador que você está usando. Se ele não conseguir conectar, confirme que o Nexus está rodando e atualizado, e permita o acesso à rede local se o navegador pedir.