ARCHINSTALL(1)                python-archinstall                ARCHINSTALL(1)

NOME
       archinstall - Documentacao do archinstall

       archinstall e uma biblioteca que pode ser usada para instalar o Arch
       Linux. A biblioteca vem empacotada com diferentes instaladores
       pre-configurados, como o instalador padrao Instalacao guiada.

       Uma demonstracao do instalador de Instalacao guiada pode ser vista
       aqui: https://www.youtube.com/watch?v=9Xt7X_Iqg6E.

       Alguns dos recursos do Archinstall sao:

       o Separacao em contextos. A biblioteca sempre executa chamadas em ordem
         sequencial para garantir que as etapas de instalacao nao se
         sobreponham ou sejam executadas na ordem errada. Ela tambem oferece
         suporte a (e usa) envoltorios de contexto para garantir que tarefas
         de limpeza e final, como mkinitcpio, sejam chamadas quando
         necessario.

       o Transparencia total Logs e insights podem ser encontrados em
         /var/log/archinstall tanto no ISO ativo quanto parcialmente no
         sistema instalado.

       o Acessivel O Archinstall funciona com espeakup e outras ferramentas de
         acessibilidade gracas ao uso de um TUI.

INSTALACAO GUIADA
       O Archinstall vem com um Instalador Guiado pre-programado que guia voce
       pelas etapas obrigatorias, bem como algumas configuracoes opcionais que
       podem ser feitas.

       NOTA:
          Outros scripts pre-programados podem ser invocados executando
          archinstall <script> (sem .py). Para ver uma lista completa de
          scripts, execute archinstall --script list ou verifique o diretorio
          scripts do codigo-fonte.

       NOTA:
          E recomendavel executar o archinstall a partir do ISO oficial do
          Arch Linux.

       AVISO:
          O instalador nao configurara o WiFi antes do inicio da instalacao.
          Voce precisa ler sobre conectividade no Arch Linux antes de
          continuar.

   Executando a instalacao guiada
       Para iniciar o instalador, execute o seguinte no ISO mais recente do
       Arch Linux:

          archinstall

       Como o Instalador Guiado e o script padrao, isso e o equivalente a
       executar archinstall guided

       A instalacao guiada tambem oferece suporte a instalacao com respostas
       pre-configuradas para todas as etapas guiadas. Esta pode ser uma
       maneira rapida e conveniente de executar novamente uma ou varias
       instalacoes.

       Ha dois arquivos de configuracao, ambos opcionais.

   --config
       This parameter takes a local .json file as argument and contains the
       overall configuration and menu answers for the guided installer.

   --config-url
       This parameter takes a remote .json file as argument and contains the
       overall configuration and menu answers for the guided installer.

       NOTA:
          Voce sempre pode obter as opcoes mais recentes para este arquivo com
          archinstall --dry-run, que executa o instalador guiado em um modo
          seguro, onde nenhuma acao permanente sera tomada no seu sistema, mas
          simula uma execucao e salva a configuracao no disco.

   Exemplo de uso

          archinstall --config config.json

          archinstall --config-url https://domain.lan/config.json

       O conteudo de https://domain.lan/config.json:

          {
            "additional-repositories": [],
            "archinstall-language": "English",
            "audio_config": null,
            "bootloader": "Systemd-boot",
            "debug": false,
            "disk_config": {
              "config_type": "manual_partitioning",
              "device_modifications": [
                {
                  "device": "/dev/sda",
                  "partitions": [
                    {
                      "btrfs": [],
                      "flags": [
                        "boot"
                      ],
                      "fs_type": "fat32",
                      "length": {
                        "sector_size": null,
                        "total_size": null,
                        "unit": "B",
                        "value": 99982592
                      },
                      "mount_options": [],
                      "mountpoint": "/boot",
                      "obj_id": "369f31a8-2781-4d6b-96e7-75680552b7c9",
                      "start": {
                        "sector_size": {
                          "sector_size": null,
                          "total_size": null,
                          "unit": "B",
                          "value": 512
                        },
                        "total_size": null,
                        "unit": "sectors",
                        "value": 34
                      },
                      "status": "create",
                      "type": "primary"
                    },
                    {
                      "btrfs": [],
                      "flags": [],
                      "fs_type": "fat32",
                      "length": {
                        "sector_size": null,
                        "total_size": null,
                        "unit": "B",
                        "value": 100000000
                      },
                      "mount_options": [],
                      "mountpoint": "/efi",
                      "obj_id": "13cf2c96-8b0f-4ade-abaa-c530be589aad",
                      "start": {
                        "sector_size": {
                          "sector_size": null,
                          "total_size": null,
                          "unit": "B",
                          "value": 512
                        },
                        "total_size": {
                          "sector_size": null,
                          "total_size": null,
                          "unit": "B",
                          "value": 16106127360
                        },
                        "unit": "MB",
                        "value": 100
                      },
                      "status": "create",
                      "type": "primary"
                    },
                    {
                      "btrfs": [],
                      "flags": [],
                      "fs_type": "ext4",
                      "length": {
                        "sector_size": null,
                        "total_size": null,
                        "unit": "B",
                        "value": 15805127360
                      },
                      "mount_options": [],
                      "mountpoint": "/",
                      "obj_id": "3e75d045-21a4-429d-897e-8ec19a006e8b",
                      "start": {
                        "sector_size": {
                          "sector_size": null,
                          "total_size": null,
                          "unit": "B",
                          "value": 512
                        },
                        "total_size": {
                          "sector_size": null,
                          "total_size": null,
                          "unit": "B",
                          "value": 16106127360
                        },
                        "unit": "MB",
                        "value": 301
                      },
                      "status": "create",
                      "type": "primary"
                    }
                  ],
                  "wipe": false
                }
              ]
            },
            "disk_encryption": {
              "encryption_type": "luks",
              "partitions": [
                "3e75d045-21a4-429d-897e-8ec19a006e8b"
              ]
            },
            "hostname": "archlinux",
            "kernels": [
              "linux"
            ],
            "locale_config": {
              "kb_layout": "us",
              "sys_enc": "UTF-8",
              "sys_lang": "en_US"
            },
            "mirror_config": {
              "custom_servers": [
                {
                  "url": "https://mymirror.com/$repo/os/$arch"
                }
              ],
              "mirror_regions": {
                "Australia": [
                  "http://archlinux.mirror.digitalpacific.com.au/$repo/os/$arch"
                ]
              },
              "optional_repositories": [
                "testing"
              ],
              "custom_repositories": [
                {
                  "name": "myrepo",
                  "url": "https://myrepo.com/$repo/os/$arch",
                  "sign_check": "Required",
                  "sign_option": "TrustAll"
                }
              ]
            },
            "network_config": {},
            "no_pkg_lookups": false,
            "ntp": true,
            "offline": false,
            "packages": [],
            "parallel downloads": 0,
            "profile_config": null,
            "save_config": null,
            "script": "guided",
            "silent": false,
            "swap": true,
            "timezone": "UTC",
            "version": "2.6.0"
          }

   Opcoes de --config
       AVISO:
          Todas as entradas de chave e valor devem estar em conformidade com o
          padrao JSON. Abaixo estao exemplos legiveis por humanos com links,
          quebrando efetivamente a sintaxe. Adapte as descricoes abaixo para
          atender as suas necessidades e ao formato JSON.

       NOTA:
          Role para a direita na tabela para ver as opcoes necessarias.

   Opcoes JSON

+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|Chave                   | Valor(es)                                                                                         | Descricao                                                                  | Obrigatorio   |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|additional-repositories | [ multilib, testing ]                                                                             | Habilita um ou mais repositorios de teste e multilib antes de prosseguir   | Nao           |
|                        |                                                                                                   | com a instalacao                                                           |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|archinstall-language    | lang                                                                                              | Define o idioma da interface de usuario de base texto (TUI) usado          | Nao           |
|                        |                                                                                                   | (certifique-se de usar o valor ``lang``, e nao ``abbr``)                   |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|audio_config            | pipewire, pulseaudio                                                                              | Servidor de audio a ser instalado                                          | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|bootloader              | Systemd-boot, grub                                                                                | Gerenciador de inicializacao a ser instalado (grub sendo obrigatorio em    | Sim           |
|                        |                                                                                                   | maquinas BIOS)                                                             |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|debug                   | true, false                                                                                       | Habilita saida de depuracao                                                | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|disk_config             | Leia mais em Configuracao de disco                                                                | Contem a configuracao de disco desejada a ser usada durante a instalacao   | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|disk_encryption         | Leia mais em Criptografia de disco                                                                | Parametros para criptografia de disco aplicados sobre disk_config          | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|hostname                | str                                                                                               | Uma string que define o nome de maquina da sua maquina na rede (o padrao e | Nao           |
|                        |                                                                                                   | ``archinstall``)                                                           |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|kernels                 | [ linux, linux-hardened, linux-lts, linux-rt, linux-rt-lts, linux-zen ]                           | Define quais kernels devem ser instalados e configurados nas opcoes do     | Sim           |
|                        |                                                                                                   | gerenciador de inicializacao                                               |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|custom-commands         | Leia mais em Comandos personalizados                                                              | Comandos personalizados que serao executados apos a instalacao com chroot  | Nao           |
|                        |                                                                                                   | dentro do sistema instalado                                                |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|locale_config           | {kb_layout: lang, sys_enc: Character encoding, sys_lang: locale}                                  | Define o mapa de teclas do teclado, a codificacao do sistema e a           | Nao           |
|                        |                                                                                                   | localidade do sistema                                                      |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|mirror_config           | {custom_mirrors: [ https://... ], mirror_regions: { "Worldwide": [                                | Define varios espelhos (o padrao e o ``/etc/pacman.d/mirrors`` da ISO, se  | Nao           |
|                        | "https://geo.mirror.pkgbuild.com/$repo/os/$arch" ] } }                                            | nao definido)                                                              |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|network_config          | `veja as opcoes em Configuracao de rede`                                                          | Define qual tipo de configuracao de rede (se houver) deve ser usado        | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|no_pkg_lookups          | true, false                                                                                       | Desabilita verificacao de pacotes em https://archlinux.org/packages/       | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|ntp                     | true, false                                                                                       | Habilita ou desabilita NTP durante a instalacao                            | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|offline                 | true, false                                                                                       | Habilita ou desabilita certas verificacoes online tal como alcance de      | Nao           |
|                        |                                                                                                   | espelhos etc.                                                              |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|packages                | [ <pacote1>, <pacote2>, ... ]                                                                     | Uma lista de pacotes para instalar durante a instalacao                    | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|parallel downloads      | 0-<infinity>                                                                                      | Define um determinado numero de downloads paralelos a serem usados         | Nao           |
|                        |                                                                                                   | <?><?>pelo pacman                                                          |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|profile_config          | `leia mais na secao de perfis`                                                                    | Instala um perfil dado se definido                                         | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|script                  | guided (padrao), minimal, only_hdd, unattended                                                    | Quando usado para executar automaticamente uma instalacao, isso define     | Nao           |
|                        |                                                                                                   | qual script executar automaticamente                                       |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|silent                  | true, false                                                                                       | Desabilita ou habilita perguntas do usuario usando o TUI                   | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|swap                    | true, false                                                                                       | Habilita ou desabilita swap                                                | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|timezone                | timezone                                                                                          | Define um fuso horario para o sistema instalado                            | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
       NOTA:
          Se nenhuma entrada for encontrada em disk_config, a instalacao
          guiada do archinstall usara o que estiver montado atualmente em
          /mnt/archinstall sem executar nenhuma operacao de disco.

   Opcoes para --creds
       Creds e um arquivo de configuracao separado para separar opcoes normais
       de dados mais sensiveis, como senhas. Abaixo esta um exemplo de como
       definir a senha de root e abaixo disso estao descricoes de outros
       valores que podem ser definidos.

          {
              "root_enc_password" : "SecretSanta2022"
          }

   Opcoes de --creds

    +---------------------+--------------------+------------------+---------------+
    |Chave                | Valores            | Descricao        | Obrigatorio   |
    +---------------------+--------------------+------------------+---------------+
    |!encryption-password | str                | Senha para       | Nao           |
    |                     |                    | criptografar o   |               |
    |                     |                    | disco, nao       |               |
    |                     |                    | criptografada se |               |
    |                     |                    | a senha nao for  |               |
    |                     |                    | fornecida        |               |
    +---------------------+--------------------+------------------+---------------+
    |root_enc_password    | str                | A senha da conta | Nao           |
    |                     |                    | root             |               |
    +---------------------+--------------------+------------------+---------------+
    |users                | 0.0 3.5  {         | Lista de         | Talvez        |
    |                     | "username":        | credenciais de   |               |
    |                     | "<USERNAME>",      | usuarios         |               |
    |                     | "enc_password":    | regulares, veja  |               |
    |                     | "<PASSWORD_HASH>", | a configuracao   |               |
    |                     | "sudo": false }    | para referencia  |               |
    |                     | 168u  168u         |                  |               |
    +---------------------+--------------------+------------------+---------------+
       NOTA:
          users is optional only if root_enc_password was set. users will be
          enforced otherwise and the minimum amount of users with sudo
          privileges required will be set to 1.

PROBLEMAS CONHECIDOS
       Alguns problemas estao fora do escopo do projeto archinstall, e os que
       conhecemos estao listados abaixo.

   Espera pela sincronizacao de tempo #2144
       A causa raiz usual disso e a topologia da rede. Mais especificamente,
       timedatectl show nao pode executar uma sincronizacao de tempo adequada
       com os servidores padrao.

       Reiniciar systemd-timesyncd.service pode funcionar, mas na maioria das
       vezes e necessario configurar /etc/systemd/timesyncd.conf para
       corresponder ao seu projeto de rede.

       NOTA:
          Se voce sabe que a hora na maquina esta correta, voce pode executar
          archinstall --skip-ntp para ignorar a sincronizacao de hora.

   Waiting for Arch Linux keyring sync (archlinux-keyring-wkd-sync) to
       complete. #2679
       The archlinux-keyring-wkd-sync.service or
       archlinux-keyring-wkd-sync.timer can hang "indefinitely" some times.
       This is usually due to an inability to reach the key servers, or a slow
       connection towards key servers.

       The script /usr/bin/archlinux-keyring-wkd-sync can be run manually, to
       verify if it's executing slowly or not.

       If systemctl show --property=ActiveEnterTimestamp --no-pager
       archlinux-keyring-wkd-sync.timer shows nothing, it means the built-in
       sync never finished. Likewise systemctl show --no-pager -p SubState
       --value archlinux-keyring-wkd-sync.service most likely shows dead,
       which means the service never completed.

       To fix this, try the following:

          # killall gpg-agent
          # rm -rf /etc/pacman.d/gnupg
          # pacman-key --init
          # pacman-key --populate
          # pacman -Sy archlinux-keyring
          # systemctl restart archlinux-keyring-wkd-sync.timer

       NOTA:
          If you know the ISO is the latest, and that you have valid GPG keys,
          try archinstall --skip-wkd to ignore waiting for the sync.

          If you skip WKD sync, you might end up with:

             > error: archinstall: signature from "Anton Hvornum (Torxed) <torxed@archlinux.org>" is unknown trust
             > :: File /var/cache/pacman/pkg/archinstall-1.2.3-4-x86_64.pkg.tar.xz is corrupted (invalid or corrupted package (PGP signature)).
             > Do you want to delete it? [Y/n]

   Ausencia do driver proprietario da Nvidia #2002
       Em alguns casos, o driver nvidia pode nao ter todos os pacotes
       necessarios instalados. Isso ocorre devido a selecao do kernel e/ou
       configuracoes de hardware que exigem pacotes adicionais para funcionar
       corretamente.

       Uma solucao alternativa comum e instalar o pacote linux-headers e
       nvidia-dkms

   Erro em CPUs ARM, 32 bits e outros tipos #1686, #2185
       Este e um problema conhecido e abrangente. Oficialmente apenas X'tty:
       link
       https://wiki.archlinux.org/title/Frequently_asked_questions#What_architectures_does_Arch_support?'x86_64
       tem suporte no Arch Linux. Portanto, pouco esforco foi feito para dar
       suporte a outras plataformas.

       Em teoria, outras arquiteturas deveriam funcionar, mas pequenas
       peculiaridades podem surgir.

       Pull requests sao bem-vindas, mas, por favor, sejam respeitosos com os
       atrasos em mesclar. Outras correcoes, problemas ou recursos serao
       priorizados pelos motivos acima.

   O chaveiro esta desatualizado #2213
       Problemas de chave ausentes tendem a ser que o pacote archlinux-keyring
       esta desatualizado, geralmente como resultado de uma ISO desatualizada.
       Ha uma tentativa do upstream de corrigir esse problema, que e o
       archlinux-keyring-wkd-sync.service

       O servico inicia quase imediatamente durante a inicializacao e, se a
       rede nao for configurada a tempo, o servico falhara. Posteriormente, a
       execucao do archinstall pode operar em um chaveiro antigo, apesar de
       haver um servico de atualizacao para isso.

       Nao ha realmente nenhuma maneira de contornar esse problema de forma
       confiavel ao longo do tempo no archinstall. Em vez disso, esforcos para
       o servico upstream devem ser considerados o caminho a seguir. E/ou
       chaves nao expirando entre uma quantidade sensata de ISOs.

       NOTA:
          O problema tambem pode acontecer em novas ISOs, mesmo alguns dias
          apos o lancamento, pois algumas chaves podem expirar logo apos o
          chaveiro ser "gravado" na ISO.

       NOTA:
          Outro problema comum relacionado a rede nao estar configurada e que
          o tempo pode nao estar definido corretamente - resultando na
          incapacidade de atualizacao do chaveiro. Veja Espera pela
          sincronizacao de tempo #2144.

   Pacotes AUR
       Este tambem e um problema geral. AUR nao e suportado, e ate que isso
       mude, nao podemos usar pacotes AUR para resolver solicitacoes de
       recursos em archinstall.

       Isso significa que solicitacoes de recursos como suporte a sistemas de
       arquivos como ZFS nao podem ser adicionadas, e problemas tambem nao
       podem ser resolvidos usando pacotes AUR.

       NOTA:
          Mas com o espirito de dar opcoes a comunidade, archinstall suporta
          plugins Python, o que significa que voce pode executar archinstall
          --plugin <url> e obter um plugin do AUR.

          torxed/archinstall-aur e uma implementacao de referencia para
          plugins:

             # archinstall --plugin https://archlinux.life/aur-plugin

          phisch/archinstall-aur e outra alternativa:

             # archinstall --plugin https://raw.githubusercontent.com/phisch/archinstall-aur/master/archinstall-aur.py

          AVISO:
             Isso permitira o uso nao suportado do AUR durante a instalacao.

RELATAR PROBLEMAS & BUGS
       Problemas e bugs devem ser relatados em
       https://github.com/archlinux/archinstall/issues.

       Perguntas gerais, melhorias e problemas de seguranca tambem podem ser
       relatados la. Para problemas rapidos ou se precisar de ajuda, va ate o
       servidor Discord que tem um canal de ajuda.

   Arquivos log
       Ao submeter um pedido de ajuda, inclua o
       /var/log/archinstall/install.log.  Ele pode ser encontrado tanto no ISO
       ao vivo quanto no sistema de arquivos instalado se os pacotes base
       foram amarrados.

       DICA:
          Uma maneira facil de enviar logs e curl -F'file=@/var/log/archinstall/install.log' https://0x0.st.
          Tenha cuidado ao enviar outros arquivos de log, mas archinstall promete manter install.log seguro para publicacao publica!


       Ha arquivos de log adicionais em /var/log/archinstall/ que podem ser
       uteis:

          o /var/log/archinstall/user_configuration.json - Armazena a maioria
            das respostas guiadas no instalador

          o /var/log/archinstall/user_credentials.json - Armazena todos os
            nomes de usuarios ou senhas, podem ser passados <?><?>para --creds

          o /var/log/archinstall/user_disk_layouts.json - Armazena os discos
            escolhidos e seus layouts

          o /var/log/archinstall/install.log - Um arquivo de log sobre quais
            etapas foram executadas pelo archinstall

          o /var/log/archinstall/cmd_history.txt - Um historico completo de
            comandos, comando por comando, em ordem

          o /var/log/archinstall/cmd_output.txt - Uma saida bruta de todos os
            comandos que foram executados pelo archinstall

       AVISO:
          Nos apenas tentamos garantir que /var/log/archinstall/install.log
          esteja livre de informacoes sensiveis. Qualquer outro arquivo de log
          deve ser fornecido com o maximo cuidado!

DISCORD
       Ha um canal do Discord que e frequentado por alguns colaboradores.

       Para entrar no servidor, va para https://discord.gg/aDeMffrxNg e entre.
       Nao ha muitas regras alem do bom senso e de tratar os outros com
       respeito. O bate-papo geral tambem e para coisas fora do topico.

       Ha a funcao @Party Animals se voce quiser notificacoes de novos
       lancamentos que sao postados no canal #Release Party. Outra coisa e que
       a funcao @Contributors pode ser ativada por contribuidores escrevendo
       !verify e seguindo o processo de verificacao.

       Entre, esperamos ver voce la! : )

BIBLIOTECA PYTHON
       O Archinstall e enviado em PyPi como archinstall. Mas a biblioteca
       tambem pode ser instalada manualmente.

       AVISO:
          Essas etapas nao sao necessarias se voce quiser usar o archinstall
          no ISO oficial do Arch Linux.

   Instalando com pacman
       Archinstall esta nos link
       https://wiki.archlinux.org/index.php/Official_repositories'repositorios
       oficiais. E ele tambem instalara o archinstall como uma biblioteca
       python.

       Para instalar a biblioteca e o script archinstall:

          pacman -S archinstall

       Como alternativa, voce pode instalar apenas a biblioteca e nao o
       executavel auxiliar usando o pacote python-archinstall.

   Instalando a partir do PyPI
       The basic concept of PyPI applies using pip.

          pip install archinstall

   Instalando a partir do codigo-fonte
       Voce tambem pode instalar usando o codigo-fonte. Para simplificar,
       usaremos git clone neste exemplo.

          git clone https://github.com/archlinux/archinstall

       Voce pode mover a pasta para o seu projeto e simplesmente fazer

          import archinstall

       Ou voce pode usar o build e o installer do PyPA para instala-lo no
       caminho do modulo do Python.

          $ cd archinstall
          $ python -m build .
          $ python -m installer dist/*.whl

MODULO PYTHON
       O Archinstall suporta execucao em modo de modulo. A maneira como a
       biblioteca e invocada no modo de modulo e limitada a execucao de
       scripts na pasta scripts.

       Portanto, e importante colocar qualquer script ou perfil que voce
       deseja invocar na pasta de exemplos antes de compilar e instalar.

   Pre-requisitos
       Vamos supor que voce seguiu o metodo Instalando a partir do
       codigo-fonte. Antes de realmente instalar a biblioteca, voce precisara
       colocar seus scripts de instalacao personalizados em scripts como um
       arquivo python.

       Mais sobre como cria-los na proxima secao.

       AVISO:
          Isso esta sujeito a alteracoes no futuro, pois esse metodo e um
          pouco rigido no momento. O caminho do script se tornara um
          parametro. Mas, por enquanto, isso e por design.

   Criando um script
       Vamos criar um test_installer - instalador como exemplo. Isso pressupoe
       que a pasta ./archinstall seja um git-clone do repositorio principal.
       Comecamos criando "scripts/test_installer.py". O posicionamento aqui e
       importante mais tarde.

       This script can now already be called using python -m archinstall
       --script test_installer after a successful installation of the library
       itself.  But the script won't do much. So we'll do something simple
       like list all the hard drives as an example.

       Para fazer isso, comecaremos importando archinstall em nosso
       "scripts/test_installer.py" e chamaremos uma funcao em archinstall.

          from archinstall.lib.disk.device_handler import device_handler
          from pprint import pprint

          pprint(device_handler.devices)

       Agora, va em frente e faca referencia ao metodo de instalacao
       Instalando a partir do codigo-fonte. Apos executar python -m
       archinstall test_installer, ele deve imprimir algo parecido com:

          [
              BDevice(
                  disk=<parted.disk.Disk object at 0x7fbe17156050>,
                  device_info=_DeviceInfo(
                      model='PC801 NVMe SK hynix 512GB',
                      path=PosixPath('/dev/nvme0n1'),
                      type='nvme',
                      total_size=Size(value=512110190592, unit=<Unit.B: 1>,
                      sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                      free_space_regions=[
                          <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4250>,
                          <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4c50>,
                          <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4a10>],
                      sector_size=SectorSize(value=512, unit=<Unit.B: 1>),
                      read_only=False,
                      dirty=False
                  ),
                  partition_infos=[
                      _PartitionInfo(
                          partition=<parted.partition.Partition object at 0x7fbe166c4a90>,
                          name='primary',
                          type=<PartitionType.Primary: 'primary'>,
                          fs_type=<FilesystemType.Fat32: 'fat32'>,
                          path='/dev/nvme0n1p1',
                          start=Size(value=2048, unit=<Unit.sectors: 'sectors'>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                          length=Size(value=535822336, unit=<Unit.B: 1>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                          flags=[
                              <PartitionFlag.BOOT: flag_id=1, alias=None>,
                              <PartitionFlag.ESP: flag_id=18, alias=None>
                          ],
                          partn=1,
                          partuuid='a26be943-c193-41f4-9930-9341cf5f6b19',
                          uuid='6EE9-2C00',
                          disk=<parted.disk.Disk object at 0x7fbe17156050>,
                          mountpoints=[
                              PosixPath('/boot')
                          ],
                          btrfs_subvol_infos=[]
                      ),
                      _PartitionInfo(...)
                  ]
              )
          ]

       Isso significa que seu script esta no lugar certo e archinstall esta
       funcionando conforme o esperado.

       NOTA:
          A maioria das chamadas, incluindo a acima, requer privilegios de
          root.

PLUGINS PYTHON
       archinstall suporta plugins por meio de dois metodos.

       O primeiro metodo e diretamente via parametro --plugin ao executar como
       uma ferramenta CLI. Isso carregara um plugin especifico localmente ou
       remotamente via um caminho.

       O segundo metodo e via a descoberta de plugins embutida do Python
       usando pontos de entrada categorizados como archinstall.plugin.

   Parametro --plugin
       O parametro tem o beneficio de ser armazenado no estado --conf, o que
       significa que ao executar novamente uma instalacao -- o plugin sera
       carregado automaticamente. Sua limitacao e que ele requer que um
       caminho inicial seja conhecido e escrito e seja trabalhoso.

   Descoberta de plugins
       Este metodo permite que varios plugins sejam carregados com a
       desvantagem de que eles precisam ser instalados previamente no sistema
       que executa archinstall. Isso tem como alvo principalmente aqueles que
       constroem seus proprios ISOs e configuracoes especificas de pacotes
       para suas necessidades.

   O que e suportado?
       Atualmente, a documentacao para isso e escassa. Ate que isso seja
       resolvido, a melhor maneira de encontrar recursos suportados e
       pesquisar o codigo-fonte para plugin.on_, pois isso dara uma indicacao
       clara de quais chamadas sao feitas para plugins.

   Como ela funciona?
       Os plugins archinstall usam uma abordagem orientada a descoberta, onde
       os plugins sao consultados para certas funcoes. Como exemplo, se um
       plugin tem a seguinte funcao:

          def on_pacstrap(*packages):
              ...

       A funcao archinstall.Pacman().strap(["alguns pacotes"]) e codificada
       para iterar plugins e procurar por on_pacstrap no plugin. Se a funcao
       existir, .strap() chamara a funcao do plugin e substituira a lista de
       pacotes inicial pelo resultado do plugin.

       A melhor maneira de documentar essas chamadas ainda nao foi decidida,
       pois e dificil documentar esse comportamento dinamicamente.

   Escrevendo seu proprio?
       A maneira mais simples atualmente e olhar para uma implementacao de
       referencia ou para a comunidade. Duas delas sao:

       o torxed/archinstall-aur

       o phisch/archinstall-aur

       E procurar por plugin.on_ na base de codigo para descobrir o que
       archinstall ira procurar. Pull requests sao bem-vindas para ampliar o
       suporte para isso.

ARCHINSTALL.INSTALLER
       O instalador e a classe principal para acessar uma instancia de
       instalacao. Voce pode olhar para essa classe como a instalacao que voce
       tem ou ira executar.

       Qualquer coisa relacionada a parte interna da instalacao sera
       encontrada nesta classe.

AUTOR
       Anton Hvornum

DIREITOS AUTORAIS
       2022, Anton Hvornum

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Rafael Fontenelle <rafaelff@gnome.org>

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

                                 July 30, 2025                  ARCHINSTALL(1)