Pular para o conteúdo principal
Versão: 1.0 beta

Instalação nativa por release assinada

A release estável Nexus v1 ainda não foi homologada nem publicada. O source release/v1.0.0 declara 1.0.0-beta.10 na linha beta.10. Plataformas e instaladores exigem validação e assinatura no SHA exato; o registro anterior de v1.0.0-beta.1 é histórico, não confirmação de URL ativa.

Quero…Documento
DEB e matriz de artefatosPacotes e artefatos
Rodar no Docker (CLI + Web)Docker compatibilidade
Compilar o source como desenvolvedorBuild
Ver a matriz de suporteSuporte de plataformas

Instalação binária​

Nenhum endereço de download de artefato foi validado nesta revisão. Antes de seguir um link de instalação, confirme a existência da release, a plataforma, o SHA, o checksum e a assinatura no canal oficial. Não execute um curl | bash inventado ou baseado em tag histórica.

O caminho para quem pretende compilar o source público está em Desenvolvimento a partir do source. Uma versão binária documentada será disponibilizada somente após os gates exigidos em Suporte de plataformas.

Windows e macOS​

O trabalho anteriormente planejado para a linha 1.1 foi incorporado à própria v1.0 enquanto ela ainda está em beta. O candidato candidato da linha v1 inclui Linux + Windows + macOS no source. A publicação dos artefatos nativos continua bloqueada até o mesmo SHA concluir a certificação correspondente.

Windows amd64​

O caminho de distribuição passa a ser o instalador NSIS assinado:

nexus-setup-Windows_x86_64.exe

Windows amd64 faz parte do candidato candidato da linha v1. A certificação exige Authenticode válido, timestamp, build Wails nativo, ConPTY/Named Pipe E2E e smoke completo de install/version/doctor/uninstall. O NSIS instala também o nexus-hud.exe, certificado e assinado no mesmo SHA. install.ps1 continua disponível para automação, mas o instalador nativo é o bootstrap recomendado para usuários Windows.

macOS arm64​

O caminho de distribuição passa a ser o pacote notarizado:

nexus-installer_Darwin_arm64.pkg

macOS arm64 faz parte do candidato candidato da linha v1. A certificação exige Developer ID, notarização Apple, stapling, Gatekeeper, build Wails nativo, PTY/socket E2E e smoke completo de install/version/doctor/uninstall. O pacote instala o CLI em /usr/local/bin/nexus, o app em /Applications/IAPro Nexus.app, o HUD em /Applications/IAPro Nexus HUD.app e nexus-uninstall para remoção preservando dados.

Consulte Suporte de plataformas para os runners, secrets e gates exact-SHA.

O que o instalador verifica​

A instalação é fail-closed:

update-manifest.json
  + update-manifest.sig
          |
          v
Ed25519 com trust root embutida
          |
          v
SHA-256 do artifact
          |
          v
extração segura
          |
          v
nexus version --json
          |
          v
versão interna == versão solicitada
          |
          v
substituição do binário

Se assinatura, hash, artifact, extração ou versão interna divergirem, o binário não é aceito.

A chave pública e o key ID usados pelo build de release são versionados em UPDATE_PUBLIC_KEY e UPDATE_KEY_ID; o workflow de publicação falha quando os secrets protegidos divergem desses contratos.

Upgrade​

nexus update check
nexus update

Instalações gerenciadas por pacote não são sobrescritas silenciosamente pelo self-updater.

Para migrar deliberadamente de beta para stable, use a versão stable pinada com o instalador assinado ou nexus update --channel stable quando o cliente suportar troca de canal.

Desinstalação​

O método depende do pacote que foi efetivamente instalado. Use o desinstalador fornecido e verificado com aquele release; não use URLs presumidas de versões anteriores. Consulte a documentação da distribuição certificada antes de remover dados.

Desenvolvimento a partir do source​

O source é um caminho de engenharia, não o bootstrap recomendado de cliente.

Requisitos para o fluxo manual abaixo: Go 1.25+, Bun 1.3.9+, Git e Make. No Windows, install.ps1 -BuildFromSource compila diretamente com Bun + Go e não exige GNU Make.

git clone https://github.com/IAPro-Community/nexus.git
cd nexus
bun install --cwd web --frozen-lockfile
make build
./nexus version
./nexus doctor

Builds de desenvolvimento e o source integrado não transformam uma plataforma em suportada. A matriz pública muda somente depois da evidência exact-SHA.

Diagnóstico​

nexus doctor --json

No Docker, probes de Desktop e runtimes nativos podem aparecer como N/A.

Próximo passo​

Primeiro projeto

Homologação do candidato da linha v1​

Enquanto o GitHub Actions estiver indisponível por créditos, execute a homologação automatizável localmente:

./scripts/homologate-beta.sh

No Windows:

.\scripts\homologate-beta.ps1

A evidência é gravada por SHA em DEV/validation/local-beta/<VERSION>/<SHA>/<plataforma>/. O script também gera a lista de checks manuais que não podem ser simulados com segurança.