From ArchWiki
Jump to navigation Jump to search

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 [1] for that.

Warning: 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 /var/log/archinstall/install.log.
Note: archinstall has experimental support for BIOS via GRUB.

Running the installer

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: There is a bunch of stuff in User:Torxed#Running_the_installer that's not part of the upstream documentation. (Discuss in Talk:Archinstall)

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:

# archinstall

The guided installer will perform (query) the following steps:

  1. configure the locale;
  2. select the mirrors;
  3. partition the disks;
  4. format the partitions;
  5. enable disk encryption (optional);
  6. set the hostname;
  7. set the root password;
  8. install a boot loader (limited to systemd-boot for UEFI and GRUB for BIOS).
Warning: 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.
Note: 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.

See also