archinstall is a helper library to install Arch Linux. It is packaged with different pre-configured installers, such as a "guided" installer.
This document does not discuss use of archinstall as a Python library; see the official documentation for that.
archinstall is experimental
software and offers different defaults than the regular installation
process. When using a system installed with archinstall, please mention so in support requests and provide
archinstall has experimental support for BIOS via GRUB
Running the installer
First, acquire and boot the live medium as described in Installation guide#Pre-installation. The archinstall package is part of the live medium and can be run directly:
The guided installer will perform (query) the following steps:
- configure the locale;
- select the mirrors;
- partition the disks;
- format the partitions;
- enable disk encryption (optional);
- set the hostname;
- set the root password;
- install a boot loader (limited to systemd-boot for UEFI and GRUB for BIOS).
Leaving the root password blank disables the root account, using sudo
for privilege escalation. As this may cause you to lock yourself out of your system, this is generally not advised. See Sudo#Disable root login
The installer can configure wired interfaces on the installed system using Systemd-networkd
or it can copy the configuration used on the ISO. That means, if you configure a wireless interface using Iwd#iwctl
, its configuration, including the network's password, will be copied to the installed system. It also copies the configuration for wired interfaces that's present on the ISO.
Additional packages can be installed by specifying them after the
Write additional packages to install prompt.
Once the installation is complete, green text should appear saying that it’s safe to reboot, which is also the command you use to reboot.
archinstall includes profiles, or sets of packages and pre-configured options which can be installed next to the base system.
Warning: Shipped profiles are specific to archinstall and not supported by package maintainers. Users are advised to check the details of each profile before using it.