Archinstall: Difference between revisions
(Remove outdated information, since GRUB is currently available and usable for both UEFI and BIOS.) |
m (Remove second link to wikipedia, use interwiki prefix, sort language links) |
||
| (19 intermediate revisions by 14 users not shown) | |||
| Line 1: | Line 1: | ||
{{Lowercase title}} | {{Lowercase title}} | ||
[[Category:Installation process]] | [[Category:Installation process]] | ||
[[cs:Archinstall]] | |||
[[es:Archinstall]] | |||
[[fr:Archinstall]] | [[fr:Archinstall]] | ||
[[ja:Archinstall]] | [[ja:Archinstall]] | ||
[[pt:Archinstall]] | [[pt:Archinstall]] | ||
[[ru:Archinstall]] | |||
[[tr:Archinstall]] | |||
[[zh-hans:Archinstall]] | [[zh-hans:Archinstall]] | ||
[https:// | [https://archinstall.archlinux.page/ archinstall] is a helper library which automates the installation of [[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 [https:// | This document does not discuss use of archinstall as a Python library; see [https://archinstall.archlinux.page/installing/python.html the official documentation] for that. | ||
{{Warning| | {{Warning| | ||
* ''archinstall'' stores all user and (secondary) disk encryption passwords in plain text. [https://github.com/archlinux/archinstall/issues/1111 | * ''archinstall'' stores all user and (secondary) disk encryption passwords in plain text. [https://github.com/archlinux/archinstall/issues/1111] | ||
* ''archinstall'' offers different defaults than the regular [[Installation guide|installation]] process. When using a system installed with archinstall, please mention so in support requests and provide {{ic|/var/log/archinstall/install.log}}. | * ''archinstall'' offers different defaults than the regular [[Installation guide|installation]] process. When using a system installed with archinstall, please mention so in support requests and provide {{ic|/var/log/archinstall/install.log}}. | ||
}} | |||
== Running the installer == | == Running the installer == | ||
First, acquire and [[ | First, acquire and [[Installation guide#Boot the live environment|boot the live medium]] as described in [[Installation guide#Pre-installation]]. The {{Pkg|archinstall}} package is part of the live medium and can be run directly: | ||
# archinstall | # archinstall | ||
The guided installer will perform | The guided installer will perform or ask user input for multiple steps, described in [https://archinstall.archlinux.page/installing/guided.html the official documentation]. | ||
{{Warning|Leaving the root password blank disables the root account, using [[sudo]] for privilege | {{Warning|Leaving the root password blank disables the root account, using [[sudo]] for privilege elevation. 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.}} | {{Note|The installer can configure wired interfaces on the installed system using [[Systemd-networkd]] or it can copy the configuration used on the [[Wikipedia:Optical disc image|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 {{ic|Write additional packages to install}} prompt. | Additional packages can be installed by specifying them after the {{ic|Write additional packages to install}} prompt. | ||
Once the installation is complete, green text should appear saying that | Once the installation is complete, green text should appear saying that it is safe to reboot, which is also the command you use to reboot. | ||
=== Profiles === | === Profiles === | ||
archinstall includes [https://gitlab.archlinux.org/archlinux/archinstall/-/tree/master/ | archinstall includes [https://gitlab.archlinux.org/archlinux/archinstall/-/tree/master/archinstall/default_profiles 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.}} | {{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.}} | ||
| Line 48: | Line 42: | ||
== See also == | == See also == | ||
* [https://archinstall. | * [https://archinstall.archlinux.page/installing/guided.html python-archinstall: guided] | ||
Latest revision as of 07:46, 23 March 2024
archinstall is a helper library which automates the installation of 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.
Warning:
- archinstall stores all user and (secondary) disk encryption passwords in plain text. [1]
- archinstall 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.
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:
# archinstall
The guided installer will perform or ask user input for multiple steps, described in the official documentation.
Warning: Leaving the root password blank disables the root account, using sudo for privilege elevation. 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 is safe to reboot, which is also the command you use to reboot.
Profiles
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.