Documentação · versão 1.2.1

Documentação

Guias para instalar, conhecer o sistema e contribuir. A referência técnica é mantida junto ao código, no repositório do projeto.

Construir a partir do código

O repositório de desenvolvimento é privado. Os links técnicos desta página exigem acesso autorizado no GitHub. As ISOs ainda não estão disponíveis para download público.

Quem já tem acesso deve consultar o guia de construção da revisão que pretende testar. Ele descreve o ambiente Arch Linux, dependências, geração de recursos, validações e testes em máquina virtual.

Guia de construção (acesso restrito) · Estado do desenvolvimento · Conversar sobre contribuição

Consulte os guias públicos para conhecer os componentes antes de preparar uma instalação.

Guias

Instalação e uso

Depois da instalação

Estado dos serviços

No terminal do Neovanguard OS, execute o painel de diagnóstico. Ele mostra rede, Bitcoin, Lightning, Nostr e memória.

Terminal
neo-status

O resultado indica quais serviços estão ativos ou parados. Um serviço parado não significa, por si só, que a instalação falhou. Antes de ativá-lo, consulte sua configuração e os recursos necessários.

Para consultar as opções disponíveis, abra a ajuda. O comando abaixo exibe instruções de uso.

Terminal
neo-status --help

Esses comandos pertencem ao sistema operacional; não são comandos de desenvolvimento deste site.

Resolver problemas

Diagnóstico e relato de falhas

Comece pelos guias do sistema. Se o problema continuar, abra uma issue com a versão do sistema, a mídia usada, os passos para reproduzir e a mensagem de erro. Remova chaves privadas, senhas e outras informações pessoais antes de compartilhar a saída de um comando.

Índice

Referência para contribuir

  1. 01

    Imagens ISO

    documentation/as-isos.md

    Como funcionam as imagens Live e Install, o sistema incluído na mídia e a detecção do pendrive.

  2. 02

    Construção das imagens

    documentation/COMO-CONSTRUIR.md

    Dependências, construção de pacotes, geração da ISO e verificações com --check.

  3. 03

    Briefing técnico

    documentation/briefing-tecnico.md

    Arquitetura, decisões de implementação, validações e limitações conhecidas.

  4. 04

    Estrutura do repositório

    documentation/estrutura.md

    Organização dos diretórios, código-fonte e arquivos gerados.

  5. 05

    Componentes da sessão Live

    documentation/heranca-do-live.md

    Componentes exclusivos da sessão Live, remoção durante a instalação e verificações de build.

  6. 06

    Escopo de revisão de segurança

    documentation/security-review-scope.md

    Componentes e verificações prioritários para revisão de segurança.

Para o sistema instalado

O repositório de pacotes

Os pacotes do Neovanguard são distribuídos por este repositório, com verificação de assinatura. O sistema já inclui a chave pública e a seguinte configuração em /etc/pacman.conf.

pacman.conf
[neovanguard]
SigLevel = Required DatabaseOptional
Server = https://neovanguard.com.br/repo/$arch

Impressão digital da chave de lançamento usada para assinar pacotes e imagens:

Impressão digital da chave
9ED7 92DC EA8D 869E CD79  CE72 5F86 3B33 9A1E 5762
No próprio sistema

Ajuda dos comandos

Use --help para consultar a sintaxe e as opções dos comandos neo-* e do instalador.

Terminal
neo-status --help
neo-zap --help
nvginstall --help

Relate um problema