.\" -*- coding: UTF-8 -*-
'\" t
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de  UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ARCHINSTALL 1 "Jul 30, 2025" "" python\-archinstall
.SH NOME
archinstall \- Documentação do archinstall
.sp
\fBarchinstall\fP é uma biblioteca que pode ser usada para instalar o Arch
Linux. A biblioteca vem empacotada com diferentes instaladores
pré\-configurados, como o instalador padrão \fI\%Instalação guiada\fP.
.sp
Uma demonstração do instalador de \fI\%Instalação guiada\fP pode ser vista
aqui: \X'tty: link https://www.youtube.com/watch?v=9Xt7X_Iqg6E'\fI\%https://www.youtube.com/watch?v=9Xt7X_Iqg6E\fP\X'tty: link'\&.
.sp
Alguns dos recursos do Archinstall são:
.INDENT 0.0
.IP \(bu 2
\fBSeparação em contextos.\fP A biblioteca sempre executa chamadas em ordem
sequencial para garantir que as etapas de instalação não se sobreponham ou
sejam executadas na ordem errada. Ela também oferece suporte a \fI(e usa)\fP
envoltórios de contexto para garantir que tarefas de limpeza e final, como
\fBmkinitcpio\fP, sejam chamadas quando necessário.
.IP \(bu 2
\fBTransparência total\fP Logs e insights podem ser encontrados em
\fB/var/log/archinstall\fP tanto no ISO ativo quanto parcialmente no sistema
instalado.
.IP \(bu 2
\fBAcessível\fP O Archinstall funciona com \fBespeakup\fP e outras ferramentas de
acessibilidade graças ao uso de um TUI.
.UNINDENT
.SH "INSTALAÇÃO GUIADA"
.sp
O Archinstall vem com um \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py'\fI\%Instalador Guiado\fP\X'tty: link' pré\-programado que guia você pelas etapas obrigatórias,
bem como algumas configurações opcionais que podem ser feitas.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Outros scripts pré\-programados podem ser invocados executando \fBarchinstall <script>\fP \fI(sem .py)\fP\&. Para ver uma lista completa de scripts,
execute \fBarchinstall \-\-script list\fP ou verifique o diretório \X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link' do código\-fonte.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
É recomendável executar o \fBarchinstall\fP a partir do ISO oficial do Arch
Linux.
.UNINDENT
.UNINDENT
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
O instalador não configurará o WiFi antes do início da instalação. Você
precisa ler sobre \X'tty: link https://wiki.archlinux.org/index.php/Network_configuration'\fI\%conectividade no Arch Linux\fP\X'tty: link' antes de continuar.
.UNINDENT
.UNINDENT
.SS "Executando a instalação guiada"
.sp
Para iniciar o instalador, execute o seguinte no ISO mais recente do Arch
Linux:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Como o \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py'\fI\%Instalador Guiado\fP\X'tty: link' é o script padrão, isso é o equivalente a executar
\fBarchinstall guided\fP
.sp
A instalação guiada também oferece suporte a instalação com respostas
pré\-configuradas para todas as etapas guiadas. Esta pode ser uma maneira
rápida e conveniente de executar novamente uma ou várias instalações.
.sp
Há dois arquivos de configuração, ambos opcionais.
.SS \-\-config
.sp
This parameter takes a local \fB\&.json\fP file as argument and contains the
overall configuration and menu answers for the guided installer.
.SS \-\-config\-url
.sp
This parameter takes a remote \fB\&.json\fP file as argument and contains the
overall configuration and menu answers for the guided installer.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Você sempre pode obter as opções mais recentes para este arquivo com
\fBarchinstall \-\-dry\-run\fP, que executa o instalador guiado em um modo seguro,
onde nenhuma ação permanente será tomada no seu sistema, mas simula uma
execução e salva a configuração no disco.
.UNINDENT
.UNINDENT
.SS "Exemplo de uso"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall \-\-config config.json
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall \-\-config\-url https://domain.lan/config.json
.EE
.UNINDENT
.UNINDENT
.sp
O conteúdo de \fBhttps://domain.lan/config.json\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  "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"
}
.EE
.UNINDENT
.UNINDENT
.SS "Opções de \-\-config"
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Todas as entradas de chave e valor devem estar em conformidade com o padrão
JSON. Abaixo estão exemplos legíveis por humanos com links, quebrando
efetivamente a sintaxe. Adapte as descrições abaixo para atender às suas
necessidades e ao formato JSON.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Role para a direita na tabela para ver as opções necessárias.
.UNINDENT
.UNINDENT
.SS "Opções JSON"
.TS
box center;
l|l|l|l.
T{
Chave
T}	T{
Valor(es)
T}	T{
Descrição
T}	T{
Obrigatório
T}
_
T{
additional\-repositories
T}	T{
[ \X'tty: link https://wiki.archlinux.org/title/Official_repositories#multilib'\fI\%multilib\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Official_repositories#Testing_repositories'\fI\%testing\fP\X'tty: link' ]
T}	T{
Habilita um ou mais repositórios de teste e multilib antes de prosseguir com a instalação
T}	T{
Não
T}
_
T{
archinstall\-language
T}	T{
\X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/locales/languages.json'\fI\%lang\fP\X'tty: link'
T}	T{
Define o idioma da interface de usuário de base texto (TUI) usado \fI(certifique\-se de usar o valor \(ga\(galang\(ga\(ga, e não \(ga\(gaabbr\(ga\(ga)\fP
T}	T{
Não
T}
_
T{
audio_config
T}	T{
\X'tty: link https://wiki.archlinux.org/title/PipeWire'\fI\%pipewire\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/PulseAudio'\fI\%pulseaudio\fP\X'tty: link'
T}	T{
Servidor de áudio a ser instalado
T}	T{
Não
T}
_
T{
bootloader
T}	T{
\X'tty: link https://wiki.archlinux.org/title/Systemd\-boot'\fI\%Systemd\-boot\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/GRUB'\fI\%grub\fP\X'tty: link'
T}	T{
Gerenciador de inicialização a ser instalado \fI(grub sendo obrigatório em máquinas BIOS)\fP
T}	T{
Sim
T}
_
T{
debug
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita saída de depuração
T}	T{
Não
T}
_
T{
disk_config
T}	T{
\fILeia mais em\fP \fI\%Configuração de disco\fP
T}	T{
Contém a configuração de disco desejada a ser usada durante a instalação
T}	T{
Não
T}
_
T{
disk_encryption
T}	T{
\fILeia mais em\fP \fI\%Criptografia de disco\fP
T}	T{
Parâmetros para criptografia de disco aplicados sobre \fBdisk_config\fP
T}	T{
Não
T}
_
T{
hostname
T}	T{
\fBstr\fP
T}	T{
Uma string que define o nome de máquina da sua máquina na rede \fI(o padrão é \(ga\(gaarchinstall\(ga\(ga)\fP
T}	T{
Não
T}
_
T{
kernels
T}	T{
[ \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-hardened\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-lts\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-rt\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-rt\-lts\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-zen\fP\X'tty: link' ]
T}	T{
Define quais kernels devem ser instalados e configurados nas opções do gerenciador de inicialização
T}	T{
Sim
T}
_
T{
custom\-commands
T}	T{
\fILeia mais em\fP \fI\%Comandos personalizados\fP
T}	T{
Comandos personalizados que serão executados após a instalação com chroot dentro do sistema instalado
T}	T{
Não
T}
_
T{
locale_config
T}	T{
{kb_layout: \X'tty: link https://wiki.archlinux.org/title/Linux_console/Keyboard_configuration'\fI\%lang\fP\X'tty: link', sys_enc: \X'tty: link https://wiki.archlinux.org/title/Locale'\fI\%Character encoding\fP\X'tty: link', sys_lang: \X'tty: link https://wiki.archlinux.org/title/Locale'\fI\%locale\fP\X'tty: link'}
T}	T{
Define o mapa de teclas do teclado, a codificação do sistema e a localidade do sistema
T}	T{
Não
T}
_
T{
mirror_config
T}	T{
{custom_mirrors: [ \X'tty: link https://'\fI\%https://\fP\X'tty: link'\&... ], mirror_regions: { "Worldwide": [ "\X'tty: link https://geo.mirror.pkgbuild.com/$repo/os/$arch'\fI\%https://geo.mirror.pkgbuild.com/$repo/os/$arch\fP\X'tty: link'" ] } }
T}	T{
Define vários espelhos \fI(o padrão é o \(ga\(ga/etc/pacman.d/mirrors\(ga\(ga da ISO, se não definido)\fP
T}	T{
Não
T}
_
T{
network_config
T}	T{
\fI\(gaveja as opções em Configuração de rede\(ga\fP
T}	T{
Define qual tipo de configuração de rede \fI(se houver)\fP deve ser usado
T}	T{
Não
T}
_
T{
no_pkg_lookups
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Desabilita verificação de pacotes em \X'tty: link https://archlinux.org/packages/'\fI\%https://archlinux.org/packages/\fP\X'tty: link'
T}	T{
Não
T}
_
T{
ntp
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita ou desabilita \X'tty: link https://wiki.archlinux.org/title/Network_Time_Protocol_daemon'\fI\%NTP\fP\X'tty: link' durante a instalação
T}	T{
Não
T}
_
T{
offline
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita ou desabilita certas verificações online tal como alcance de espelhos etc.
T}	T{
Não
T}
_
T{
packages
T}	T{
[ <pacote1>, <pacote2>, ... ]
T}	T{
Uma lista de pacotes para instalar durante a instalação
T}	T{
Não
T}
_
T{
parallel downloads
T}	T{
0\-∞
T}	T{
Define um determinado número de downloads paralelos a serem usados ​​pelo \X'tty: link https://wiki.archlinux.org/title/Pacman#Enabling_parallel_downloads'\fI\%pacman\fP\X'tty: link'
T}	T{
Não
T}
_
T{
profile_config
T}	T{
\fI\(galeia mais na seção de perfis\(ga\fP
T}	T{
Instala um perfil dado se definido
T}	T{
Não
T}
_
T{
script
T}	T{
\X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py'\fI\%guided\fP\X'tty: link' \fI(padrão)\fP, \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/minimal.py'\fI\%minimal\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/only_hdd.py'\fI\%only_hdd\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/unattended.py'\fI\%unattended\fP\X'tty: link'
T}	T{
Quando usado para executar automaticamente uma instalação, isso define qual script executar automaticamente
T}	T{
Não
T}
_
T{
silent
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Desabilita ou habilita perguntas do usuário usando o TUI
T}	T{
Não
T}
_
T{
swap
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita ou desabilita swap
T}	T{
Não
T}
_
T{
timezone
T}	T{
\X'tty: link https://wiki.archlinux.org/title/System_time#Time_zone'\fI\%timezone\fP\X'tty: link'
T}	T{
Define um fuso horário para o sistema instalado
T}	T{
Não
T}
.TE
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Se nenhuma entrada for encontrada em \fBdisk_config\fP, a instalação guiada do
archinstall usará o que estiver montado atualmente em \fB/mnt/archinstall\fP
sem executar nenhuma operação de disco.
.UNINDENT
.UNINDENT
.SS "Opções para \-\-creds"
.sp
Creds é um arquivo de configuração separado para separar opções normais de
dados mais sensíveis, como senhas. Abaixo está um exemplo de como definir a
senha de root e abaixo disso estão descrições de outros valores que podem
ser definidos.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    "root_enc_password" : "SecretSanta2022"
}
.EE
.UNINDENT
.UNINDENT
.SS "Opções de \-\-creds"
.TS
box center;
l|l|l|l.
T{
Chave
T}	T{
Valores
T}	T{
Descrição
T}	T{
Obrigatório
T}
_
T{
\fB!encryption\-password\fP
T}	T{
\fBstr\fP
T}	T{
Senha para criptografar o disco, não criptografada se a senha não for fornecida
T}	T{
Não
T}
_
T{
\fBroot_enc_password\fP
T}	T{
\fBstr\fP
T}	T{
A senha da conta root
T}	T{
Não
T}
_
T{
\fBusers\fP
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    "username": "<USERNAME>",
    "enc_password": "<PASSWORD_HASH>",
    "sudo": false
}
.EE
.UNINDENT
.UNINDENT
T}	T{
Lista de credenciais de usuários regulares, veja a configuração para referência
T}	T{
Talvez
T}
.TE
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
\fBusers\fP is optional only if \fBroot_enc_password\fP was set. \fBusers\fP will be
enforced otherwise and the minimum amount of users with sudo privileges
required will be set to 1.
.UNINDENT
.UNINDENT
.SH "PROBLEMAS CONHECIDOS"
.sp
Alguns problemas estão fora do escopo do projeto \X'tty: link https://github.com/archlinux/archinstall/'\fI\%archinstall\fP\X'tty: link', e
os que conhecemos estão listados abaixo.
.SS "Espera pela sincronização de tempo \X'tty: link https://github.com/archlinux/archinstall/issues/2144'\fI\%#2144\fP\X'tty: link'"
.sp
A causa raiz usual disso é a topologia da rede. Mais especificamente,
\X'tty: link https://github.com/archlinux/archinstall/blob/e6344f93f7e476d05bbcd642f2ed91fdde545870/archinstall/lib/installer.py#L136'\fI\%timedatectl show\fP\X'tty: link' não pode executar uma sincronização de tempo adequada com
os servidores padrão.
.sp
Reiniciar \fBsystemd\-timesyncd.service\fP pode funcionar, mas na maioria das
vezes é necessário configurar \fB/etc/systemd/timesyncd.conf\fP para
corresponder ao seu projeto de rede.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Se você sabe que a hora na máquina está correta, você pode executar
\fBarchinstall \-\-skip\-ntp\fP para ignorar a sincronização de hora.
.UNINDENT
.UNINDENT
.SS "Waiting for Arch Linux keyring sync (archlinux\-keyring\-wkd\-sync) to complete. \X'tty: link https://github.com/archlinux/archinstall/issues/2679'\fI\%#2679\fP\X'tty: link'"
.sp
The \fBarchlinux\-keyring\-wkd\-sync.service\fP or
\fBarchlinux\-keyring\-wkd\-sync.timer\fP can hang "indefinitely" some times.
This is usually due to an inability to reach the key servers, or a slow
connection towards key servers.
.sp
The script \fB/usr/bin/archlinux\-keyring\-wkd\-sync\fP can be run manually, to
verify if it\(aqs executing slowly or not.
.sp
If \fBsystemctl show \-\-property=ActiveEnterTimestamp \-\-no\-pager archlinux\-keyring\-wkd\-sync.timer\fP shows nothing, it means the built\-in sync
never finished. Likewise \fBsystemctl show \-\-no\-pager \-p SubState \-\-value archlinux\-keyring\-wkd\-sync.service\fP most likely shows \fBdead\fP, which means
the service never completed.
.sp
To fix this, try the following:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# 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
.EE
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
If you know the ISO is the latest, and that you have valid GPG keys, try
\fBarchinstall \-\-skip\-wkd\fP to ignore waiting for the sync.
.sp
If you skip WKD sync, you might end up with:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
> 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]
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS "Ausência do driver proprietário da Nvidia \X'tty: link https://github.com/archlinux/archinstall/issues/2002'\fI\%#2002\fP\X'tty: link'"
.sp
Em alguns casos, o driver nvidia pode não ter todos os pacotes necessários
instalados. Isso ocorre devido à seleção do kernel e/ou configurações de
hardware que exigem pacotes adicionais para funcionar corretamente.
.sp
Uma solução alternativa comum é instalar o pacote \X'tty: link https://archlinux.org/packages/core/x86_64/linux\-headers/'\fI\%linux\-headers\fP\X'tty: link' e \X'tty: link https://archlinux.org/packages/extra/x86_64/nvidia\-dkms/'\fI\%nvidia\-dkms\fP\X'tty: link'
.SS "Erro em CPUs ARM, 32 bits e outros tipos \X'tty: link https://github.com/archlinux/archinstall/issues/1686'\fI\%#1686\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/issues/2185'\fI\%#2185\fP\X'tty: link'"
.sp
Este é um problema conhecido e abrangente. Oficialmente apenas X'tty: link https://wiki.archlinux.org/title/Frequently_asked_questions#What_architectures_does_Arch_support?'\fI\%x86_64\fP\X'tty: link' tem suporte no Arch Linux. Portanto, pouco esforço foi feito para dar
suporte a outras plataformas.
.sp
Em teoria, outras arquiteturas deveriam funcionar, mas pequenas
peculiaridades podem surgir.
.sp
Pull requests são bem\-vindas, mas, por favor, sejam respeitosos com os
atrasos em mesclar. Outras correções, problemas ou recursos serão
priorizados pelos motivos acima.
.SS "O chaveiro está desatualizado \X'tty: link https://github.com/archlinux/archinstall/issues/2213'\fI\%#2213\fP\X'tty: link'"
.sp
Problemas de chave ausentes tendem a ser que o pacote \X'tty: link https://archlinux.org/packages/core/any/archlinux\-keyring/'\fI\%archlinux\-keyring\fP\X'tty: link' está desatualizado, geralmente como resultado de uma ISO
desatualizada. Há uma tentativa do upstream de corrigir esse problema, que é
o \X'tty: link https://gitlab.archlinux.org/archlinux/archlinux\-keyring/\-/blob/7e672dad10652a80d1cc575d75cdb46442cd7f96/wkd_sync/archlinux\-keyring\-wkd\-sync.service.in'\fI\%archlinux\-keyring\-wkd\-sync.service\fP\X'tty: link'
.sp
O serviço inicia quase imediatamente durante a inicialização e, se a rede
não for configurada a tempo, o serviço falhará. Posteriormente, a execução
do \fBarchinstall\fP pode operar em um chaveiro antigo, apesar de haver um
serviço de atualização para isso.
.sp
Não há realmente nenhuma maneira de contornar esse problema de forma
confiável ao longo do tempo no \fBarchinstall\fP\&. Em vez disso, esforços para
o serviço upstream devem ser considerados o caminho a seguir. E/ou chaves
não expirando entre uma quantidade sensata de ISOs.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
O problema também pode acontecer em novas ISOs, mesmo alguns dias após o
lançamento, pois algumas chaves podem expirar logo após o chaveiro ser
\fI"gravado"\fP na ISO.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Outro problema comum relacionado à rede não estar configurada é que o tempo
pode não estar definido corretamente \- resultando na incapacidade de
atualização do chaveiro. Veja \fI\%Espera pela sincronização de tempo #2144\fP\&.
.UNINDENT
.UNINDENT
.SS "Pacotes AUR"
.sp
Este também é um problema geral. \X'tty: link https://wiki.archlinux.org/title/Arch_User_Repository#Updating_packages'\fI\%AUR não é suportado\fP\X'tty: link', e até que isso mude, não podemos usar pacotes
AUR para resolver solicitações de recursos em \fBarchinstall\fP\&.
.sp
Isso significa que solicitações de recursos como suporte a sistemas de
arquivos como \X'tty: link https://aur.archlinux.org/packages/zfs\-linux'\fI\%ZFS\fP\X'tty: link' não podem
ser adicionadas, e problemas também não podem ser resolvidos usando pacotes
AUR.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Mas com o espírito de dar opções à comunidade, \fBarchinstall\fP suporta
\fI\%plugins Python\fP, o que significa que você pode executar \fBarchinstall \-\-plugin <url>\fP e obter um plugin do AUR.
.sp
\X'tty: link https://github.com/torxed/archinstall\-aur'\fI\%torxed/archinstall\-aur\fP\X'tty: link' é uma implementação de referência para plugins:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# archinstall \-\-plugin https://archlinux.life/aur\-plugin
.EE
.UNINDENT
.UNINDENT
.sp
\X'tty: link https://github.com/phisch/archinstall\-aur'\fI\%phisch/archinstall\-aur\fP\X'tty: link' é outra alternativa:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# archinstall \-\-plugin https://raw.githubusercontent.com/phisch/archinstall\-aur/master/archinstall\-aur.py
.EE
.UNINDENT
.UNINDENT
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Isso permitirá o uso não suportado do AUR durante a instalação.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "RELATAR PROBLEMAS & BUGS"
.sp
Problemas e bugs devem ser relatados em \X'tty: link https://github.com/archlinux/archinstall/issues'\fI\%https://github.com/archlinux/archinstall/issues\fP\X'tty: link'\&.
.sp
Perguntas gerais, melhorias e problemas de segurança também podem ser
relatados lá. Para problemas rápidos ou se precisar de ajuda, vá até o
servidor Discord que tem um canal de ajuda.
.SS "Arquivos log"
.sp
Ao submeter um pedido de ajuda, inclua o
\fB/var/log/archinstall/install.log\fP\&.
Ele pode ser encontrado tanto no ISO ao vivo quanto no sistema de arquivos
instalado se os pacotes base foram amarrados.
.sp
\fBDICA:\fP
.INDENT 0.0
.INDENT 3.5
.nf
Uma maneira fácil de enviar logs é \fBcurl \-F\(aqfile=@/var/log/archinstall/install.log\(aq https://0x0.st\fP\&.
Tenha cuidado ao enviar outros arquivos de log, mas \fBarchinstall\fP promete manter \fBinstall.log\fP seguro para publicação pública!
.fi
.sp
.UNINDENT
.UNINDENT
.sp
Há arquivos de log adicionais em \fB/var/log/archinstall/\fP que podem ser
úteis:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB/var/log/archinstall/user_configuration.json\fP \- Armazena a maioria das
respostas guiadas no instalador
.IP \(bu 2
\fB/var/log/archinstall/user_credentials.json\fP \- Armazena todos os nomes de
usuários ou senhas, podem ser passados ​​para \fB\-\-creds\fP
.IP \(bu 2
\fB/var/log/archinstall/user_disk_layouts.json\fP \- Armazena os discos
escolhidos e seus layouts
.IP \(bu 2
\fB/var/log/archinstall/install.log\fP \- Um arquivo de log sobre quais etapas
foram executadas pelo archinstall
.IP \(bu 2
\fB/var/log/archinstall/cmd_history.txt\fP \- Um histórico completo de comandos,
comando por comando, em ordem
.IP \(bu 2
\fB/var/log/archinstall/cmd_output.txt\fP \- Uma saída bruta de todos os
comandos que foram executados pelo archinstall
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Nós apenas tentamos garantir que \fB/var/log/archinstall/install.log\fP esteja
livre de informações sensíveis. Qualquer outro arquivo de log deve ser
fornecido com \fBo máximo cuidado\fP!
.UNINDENT
.UNINDENT
.SH DISCORD
.sp
Há um canal do Discord que é frequentado por alguns \X'tty: link https://github.com/archlinux/archinstall/graphs/contributors'\fI\%colaboradores\fP\X'tty: link'\&.
.sp
Para entrar no servidor, vá para \X'tty: link https://discord.gg/aDeMffrxNg'\fI\%https://discord.gg/aDeMffrxNg\fP\X'tty: link' e entre. Não há muitas regras além do bom senso e de tratar os outros
com respeito. O bate\-papo geral também é para coisas fora do tópico.
.sp
Há a função \fB@Party Animals\fP se você quiser notificações de novos
lançamentos que são postados no canal \fB#Release Party\fP. Outra coisa é que a
função \fB@Contributors\fP pode ser ativada por contribuidores escrevendo
\fB!verify\fP e seguindo o processo de verificação.
.sp
Entre, esperamos ver você lá! : )
.SH "BIBLIOTECA PYTHON"
.sp
O Archinstall é enviado em \X'tty: link https://pypi.org/'\fI\%PyPi\fP\X'tty: link' como \fI\%archinstall\fP\&. Mas a biblioteca também pode ser instalada
manualmente.
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Essas etapas não são necessárias se você quiser usar o archinstall no ISO
oficial do Arch Linux.
.UNINDENT
.UNINDENT
.SS "Instalando com pacman"
.sp
Archinstall está nos link \X'tty:
https://wiki.archlinux.org/index.php/Official_repositories'\fI\%repositórios oficiais\fP\X'tty: link'\&. E ele também instalará o archinstall como uma
biblioteca python.
.sp
Para instalar a biblioteca e o script archinstall:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pacman \-S archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Como alternativa, você pode instalar apenas a biblioteca e não o executável
auxiliar usando o pacote \fBpython\-archinstall\fP.
.SS "Instalando a partir do PyPI"
.sp
The basic concept of PyPI applies using \fIpip\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install archinstall
.EE
.UNINDENT
.UNINDENT
.SS "Instalando a partir do código\-fonte"
.sp
Você também pode instalar usando o código\-fonte. Para simplificar, usaremos
\fBgit clone\fP neste exemplo.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
git clone https://github.com/archlinux/archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Você pode mover a pasta para o seu projeto e simplesmente fazer
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Ou você pode usar o \X'tty: link https://github.com/pypa/build'\fI\%build\fP\X'tty: link' e o \X'tty: link https://github.com/pypa/installer'\fI\%installer\fP\X'tty: link' do PyPA para
instalá\-lo no caminho do módulo do Python.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cd archinstall
$ python \-m build .
$ python \-m installer dist/*.whl
.EE
.UNINDENT
.UNINDENT
.SH "MÓDULO PYTHON"
.sp
O Archinstall suporta execução em \X'tty: link https://docs.python.org/3/library/__main__.html'\fI\%modo de módulo\fP\X'tty: link'\&. A maneira como a biblioteca é invocada no modo de módulo é limitada
à execução de scripts na pasta \X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link'.
.sp
Portanto, é importante colocar qualquer script ou perfil que você deseja
invocar na pasta de exemplos antes de compilar e instalar.
.SS Pré\-requisitos
.sp
Vamos supor que você seguiu o método \fI\%Instalando a partir do código\-fonte\fP. Antes de realmente instalar a biblioteca, você precisará
colocar seus scripts de instalação personalizados em \X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link' como um arquivo python.
.sp
Mais sobre como criá\-los na próxima seção.
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Isso está sujeito a alterações no futuro, pois esse método é um pouco rígido
no momento. O caminho do script se tornará um parâmetro. Mas, por enquanto,
isso é por design.
.UNINDENT
.UNINDENT
.SS "Criando um script"
.sp
Vamos criar um \fItest_installer\fP \- instalador como exemplo. Isso pressupõe
que a pasta \fI\&./archinstall\fP seja um git\-clone do repositório
principal. Começamos criando "\X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link'\fB/test_installer.py\fP". O posicionamento aqui é importante mais tarde.
.sp
This script can now already be called using \fBpython \-m archinstall \-\-script test_installer\fP after a successful installation of the library itself.  But
the script won\(aqt do much. So we\(aqll do something simple like list all
the hard drives as an example.
.sp
Para fazer isso, começaremos importando \fBarchinstall\fP em nosso "\X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link'\fB/test_installer.py\fP" e chamaremos uma função em \fBarchinstall\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from archinstall.lib.disk.device_handler import device_handler
from pprint import pprint

pprint(device_handler.devices)
.EE
.UNINDENT
.UNINDENT
.sp
Agora, vá em frente e faça referência ao método de instalação \fI\%Instalando a partir do código\-fonte\fP. Após executar \fBpython \-m archinstall test_installer\fP, ele deve imprimir algo parecido com:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[
    BDevice(
        disk=<parted.disk.Disk object at 0x7fbe17156050>,
        device_info=_DeviceInfo(
            model=\(aqPC801 NVMe SK hynix 512GB\(aq,
            path=PosixPath(\(aq/dev/nvme0n1\(aq),
            type=\(aqnvme\(aq,
            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=\(aqprimary\(aq,
                type=<PartitionType.Primary: \(aqprimary\(aq>,
                fs_type=<FilesystemType.Fat32: \(aqfat32\(aq>,
                path=\(aq/dev/nvme0n1p1\(aq,
                start=Size(value=2048, unit=<Unit.sectors: \(aqsectors\(aq>, 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=\(aqa26be943\-c193\-41f4\-9930\-9341cf5f6b19\(aq,
                uuid=\(aq6EE9\-2C00\(aq,
                disk=<parted.disk.Disk object at 0x7fbe17156050>,
                mountpoints=[
                    PosixPath(\(aq/boot\(aq)
                ],
                btrfs_subvol_infos=[]
            ),
            _PartitionInfo(...)
        ]
    )
]
.EE
.UNINDENT
.UNINDENT
.sp
Isso significa que seu script está no lugar certo e \fBarchinstall\fP está
funcionando conforme o esperado.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
A maioria das chamadas, incluindo a acima, requer privilégios de \X'tty: link https://en.wikipedia.org/wiki/Superuser'\fI\%root\fP\X'tty: link'.
.UNINDENT
.UNINDENT
.SH "PLUGINS PYTHON"
.sp
\fBarchinstall\fP suporta plugins por meio de dois métodos.
.sp
O primeiro método é diretamente via parâmetro \fB\-\-plugin\fP ao executar como
uma ferramenta CLI. Isso carregará um plugin específico localmente ou
remotamente via um caminho.
.sp
O segundo método é via a \X'tty: link https://packaging.python.org/en/latest/specifications/entry\-points/'\fI\%descoberta de plugins\fP\X'tty: link' embutida do Python usando \X'tty: link https://docs.python.org/3/library/importlib.metadata.html#entry\-points'\fI\%pontos de entrada\fP\X'tty: link' categorizados como \fBarchinstall.plugin\fP\&.
.SS "Parâmetro \-\-plugin"
.sp
O parâmetro tem o benefício de ser armazenado no estado \fB\-\-conf\fP, o que
significa que ao executar novamente uma instalação — o plugin será carregado
automaticamente. Sua limitação é que ele requer que um caminho inicial seja
conhecido e escrito e seja trabalhoso.
.SS "Descoberta de plugins"
.sp
Este método permite que vários plugins sejam carregados com a desvantagem de
que eles precisam ser instalados previamente no sistema que executa
\fBarchinstall\fP\&. Isso tem como alvo principalmente aqueles que constroem
seus próprios ISOs e configurações específicas de pacotes para suas
necessidades.
.SS "O que é suportado?"
.sp
Atualmente, a documentação para isso é escassa. Até que isso seja resolvido,
a melhor maneira de encontrar recursos suportados é pesquisar o código\-fonte
para \X'tty: link https://github.com/search?q=repo%3Aarchlinux%2Farchinstall+%22plugin.on_%22&type=code'\fI\%plugin.on_\fP\X'tty: link', pois isso dará uma indicação clara de quais chamadas são feitas para
plugins.
.SS "Como ela funciona?"
.sp
Os plugins \fBarchinstall\fP usam uma abordagem orientada à descoberta, onde os
plugins são consultados para certas funções. Como exemplo, se um plugin tem
a seguinte função:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def on_pacstrap(*packages):
    ...
.EE
.UNINDENT
.UNINDENT
.sp
A função \fBarchinstall.Pacman().strap(["alguns pacotes"])\fP é codificada para
iterar plugins e procurar por \fBon_pacstrap\fP no plugin. Se a função existir,
\fB\&.strap()\fP chamará a função do plugin e substituirá a lista de pacotes
inicial pelo resultado do plugin.
.sp
A melhor maneira de documentar essas chamadas ainda não foi decidida, pois é
difícil documentar esse comportamento dinamicamente.
.SS "Escrevendo seu próprio?"
.sp
A maneira mais simples atualmente é olhar para uma implementação de
referência ou para a comunidade. Duas delas são:
.INDENT 0.0
.IP \(bu 2
\X'tty: link https://github.com/torxed/archinstall\-aur'\fI\%torxed/archinstall\-aur\fP\X'tty: link'
.IP \(bu 2
\X'tty: link https://github.com/phisch/archinstall\-aur'\fI\%phisch/archinstall\-aur\fP\X'tty: link'
.UNINDENT
.sp
E procurar por \X'tty: link https://github.com/search?q=repo%3Aarchlinux%2Farchinstall+%22plugin.on_%22&type=code'\fI\%plugin.on_\fP\X'tty: link' na base de código para descobrir o que \fBarchinstall\fP irá
procurar. Pull requests são bem\-vindas para ampliar o suporte para isso.
.SH ARCHINSTALL.INSTALLER
.sp
O instalador é a classe principal para acessar uma instância de
instalação. Você pode olhar para essa classe como a instalação que você tem
ou irá executar.
.sp
Qualquer coisa relacionada a \fBparte interna\fP da instalação será encontrada
nesta classe.
.SH AUTOR
Anton Hvornum
.SH "DIREITOS AUTORAIS"
.\" Generated by docutils manpage writer.
2022, Anton Hvornum
.
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Rafael Fontenelle <rafaelff@gnome.org>
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .