Fork me on GitHub

Arch Linux Install Script

An easy and fast way to install Arch Linux.
Boot. Get. Configure. Install. Enjoy.

How to install See it in video

Arch Linux

What is it?

Arch Linux Install Script (or alis) installs unattended, automated and customized Arch Linux system.

It is a simple bash script that fully automates the installation of a Arch Linux system after booting from the original Arch Linux installation media. It contains the same commands that you would type and execute one by one interactively to complete the installation. The only user intervention needed is to edit a configuration file to choose the installation options and preferences from partitioning, to encryption, bootloader, file system, language and keyboard mapping, desktop environment, kernels, packages to install and graphic drivers. This automation makes the installation easy and fast.

If some time later after an system update for any reason the system does not boot correctly a recovery script is also provided to enter in a recovery mode that allows to downgrade packages or execute any other commands to restore the system. Also a log of the installation can be taken with asciinema.

Warning! This script can delete all partitions of the persistent storage. It is recommended to test it first in a virtual machine like VirtualBox.

Principles

  • Use the original Arch Linux installation media
  • Require as little interactivity as possible
  • Allow to customize the installation to cover the most common cases
  • Provide support for recovery
  • Provide support for log

Features

  • System: GPT, UEFI, BIOS
  • Storage: SATA, NVMe and MMC
  • Encryption: root partition encrypted and no encrypted
  • Partition: no LVM, LVM, LVM on LUKS
  • File system: ext4, btrfs (with subvols), xfs
  • Optional file swap (not supported in btrfs)
  • Storage: SATA, NVMe and MMC
  • Kernels: linux-lts, linux-hardened, linux-zen
  • Desktop environment: GNOME, KDE, XFCE, Mate, Cinnamon, LXDE
  • Display managers: GDM, SDDM, Lightdm, lxdm
  • Graphics controller: intel, nvidia, amd with optionally early KMS start
  • Bootloader: GRUB, rEFInd, systemd-boot
  • Periodic TRIM for SSD storage
  • Intel and AMD processors microcode
  • Optional file swap (not supported in btrfs)
  • VirtualBox guest utils
  • WPA WIFI network installation
  • Kernel compression and custom parameters
  • Users creation and add to sudoers
  • Common and custom packages installation
  • AUR utility installation (aurman, yay)
  • Script for download installation and recovery scripts and configuration files
  • Retry packages download on connection/mirror error
  • Packer support for testing in VirtualBox
  • Installation log with all commands executed and output in a file and/or asciinema video
  • Wait after installation for an abortable reboot

Installation

Download and boot from the latest original Arch Linux installation media. After boot use the following commands to start the installation.

Follow the Arch Way of doing things and learn what this script does. This will allow you to know what is happening.

Internet connection is required, with wireless WIFI connection see Wireless_network_configuration to bring up WIFI connection before start the installation.

# Load keymap
loadkeys [keymap]
# Download alis directly or with url shortener
curl https://raw.githubusercontent.com/picodotdev/alis/master/download.sh | bash
curl -sL https://bit.ly/2F3CATp | bash
# Edit alis.conf and change variables values with your preferences
vim alis.conf
# Start
./alis.sh

Video

Installation with log

# Load keymap
loadkeys [keymap]
# Download alis directly or with url shortener
curl https://raw.githubusercontent.com/picodotdev/alis/master/download.sh | bash
curl -sL https://bit.ly/2F3CATp | bash
./alis-asciinema.sh
# Edit alis.conf and change variables values with your preferences
vim alis.conf
# Start
./alis.sh
# Exit
exit
./alis-reboot.sh

Recovery

Boot from the latest original Arch Linux installation media. After boot use the following comands to start the recovery, this will allow you to enter in the arch-chroot environment.

# Load keymap
loadkeys [keymap]
# Download alis directly or with url shortener
curl https://raw.githubusercontent.com/picodotdev/alis/master/download.sh | bash
curl -sL https://bit.ly/2F3CATp | bash
# Edit alis-recovery.conf and change variables values with your last installation with alis
vim alis-recovery.conf
# Start
./alis-recovery.sh

How you can help

  • Test in VirtualBox and create an issue if something does not work, attach the main parts of the used configuration file and the error message
  • Create issues with new features
  • Send pull requests
  • Share it in social networks, forums, create a blog post or video about it

Built with Hugo and GitHub Pages. Theme based on hugo-fresh.
Arch Linux Install Script is based on Arch Linux but is NOT approved, sponsored, or affiliated with Arch Linux or its related projects.