engram-boot/docs/install.md

7.0 KiB

Arch Linux Installation

I need only a minimalistic Arch installation and then I run my bootstrap script that installs Ansible and runs the magic show...

1. Partition the disk

To check connected disks and partitions, you can use simple lsblk.

Now you can create partitions on disk using cfdisk, which is a more user-friendly TUI utility, or you can use gdisk, which is also easy, but less "clickable"...

To use EFI, we need to create a GPT table on the disk.

Usually I'm using only two partitions - one for the EFI and the second one for the BTRFS partition. EFI partition is typically 512MB of size and it's marked as EFI System. To create file systems, use the following commands (assume the disk is on sda - on NVMe it is nvme0n1 instead)

mkfs.fat -F32 /dev/sda1
mkfs.btrfs -L ArchLinux /dev/sda2

Optional: full-disk encryption. If you want encryption, put the BTRFS partition into a LUKS2 container first and create the filesystem on the mapped device:

cryptsetup luksFormat /dev/sda2
cryptsetup open /dev/sda2 relic
mkfs.btrfs -L ArchLinux /dev/mapper/relic

Then use /dev/mapper/relic instead of /dev/sda2 in every command below (mounts and UUID lookups). The name is arbitrary - just keep it consistent with the GRUB command line in section 4. The rest of the install is the same, with two extra steps marked in section 4. The passphrase is not recoverable - keep it in a password manager.

The BTRFS partition is never used directly, so you have to create at least the root subvolume. To create subvolumes, mount the BTRFS partition.

mount /dev/sda2 /mnt
cd /mnt

Now you can create your subvolumes. Subvolume names start with @ and the root subvolume is just @

btrfs subvolume create @
btrfs subvolume create @home
btrfs subvolume create @snapshots

After you create all desired subvolumes, unmount /mnt and mount all partitions and subvolumes

cd /
umount /mnt

mount -o noatime,compress=zstd,discard=async,subvol=@ /dev/sda2 /mnt
mkdir -p /mnt/{boot,home,snapshots}

mount -o noatime,compress=zstd,discard=async,subvol=@home /dev/sda2 /mnt/home
mount -o noatime,compress=zstd,discard=async,subvol=@snapshots /dev/sda2 /mnt/snapshots
mount /dev/sda1 /mnt/boot

Alright, the disk is ready and we can pacstrap Arch Linux...

2. Pacstrap Arch Linux

Pacstrap Arch Linux with some useful packages

pacstrap /mnt base base-devel linux linux-firmware linux-headers grub grub-btrfs efibootmgr btrfs-progs sudo fish xdg-utils xdg-user-dirs networkmanager wpa_supplicant wget neovim tmux

Microcode (amd-ucode / intel-ucode) is hardware-specific and installed later by the bootstrap/Ansible based on the detected CPU.

Generate fstab and check it

genfstab -U -p /mnt >> /mnt/etc/fstab
cat /mnt/etc/fstab

3. Set locale, create user, ...

Now we can "chroot" to the system and set up some basic stuff like the timezone

arch-chroot /mnt
ln -sf /usr/share/zoneinfo/Europe/Prague /etc/localtime
hwclock --systohc --utc

Check if the time is correct using the date command. Use neovim to uncomment the en_US.UTF-8 line in /etc/locale.gen and then run locale-gen

nvim /etc/locale.gen
echo LANG=en_US.UTF-8 > /etc/locale.conf
locale-gen

Set the hostname and edit the hosts file (use the machine's actual hostname)

echo <hostname> > /etc/hostname
nvim /etc/hosts

The hosts file should look like this

# Static table lookup for hostnames.
# See hosts(5) for details.

# <ip-address>  <hostname>
127.0.0.1       localhost
::1             localhost

127.0.0.1       <hostname>
::1             <hostname>
# End of file

Create the user and add him to the wheel group to enable sudo

useradd -mG wheel -s /bin/fish nevim42
passwd nevim42
EDITOR=nvim visudo

Uncomment the line %wheel ALL=(ALL:ALL) ALL

Enable colors for pacman (and yay)

nvim /etc/pacman.conf

And uncomment the Color line under Misc options. Also some packages are in the multilib repository, so uncomment the following lines

# [multilib]
# Include = /etc/pacman.d/mirrorlist

Now we can also enable some services like networking - just NetworkManager. It takes care of DHCP, ethernet, WiFi (via wpa_supplicant) and VPN on its own; nothing else needs to be enabled. Basic commands are in network.md.

systemctl enable NetworkManager

4. Bootloader/GRUB

Because we are using BTRFS, we have to add it to the modules in the initcpio

nvim /etc/mkinitcpio.conf

and add btrfs to the modules

MODULES=(btrfs)

With encryption, the initramfs must unlock the LUKS container before the root filesystem can be mounted. Switch to the systemd-based hooks (they also handle the TPM2 unlock later):

HOOKS=(base systemd autodetect microcode modconf kms keyboard sd-vconsole block sd-encrypt filesystems fsck)

Now rebuild the initramfs

mkinitcpio -p linux

Install GRUB

grub-install --target=x86_64-efi --efi-directory=/boot --bootloader-id=GRUB

With encryption, tell the initramfs where the container is. First get the UUID of the LUKS partition (not the BTRFS filesystem)

blkid -s UUID -o value /dev/sda2    # <LUKS-UUID>

and put it into /etc/default/grub

GRUB_CMDLINE_LINUX="rd.luks.name=<LUKS-UUID>=relic root=/dev/mapper/relic"

Finally generate the configuration - the same command with and without encryption

grub-mkconfig -o /boot/grub/grub.cfg

Some motherboards have a problem recognizing the GRUB bootloader on the EFI partition, so if you can't see the boot entry in your BIOS, try to rename these

mv /boot/EFI/GRUB /boot/EFI/BOOT
mv /boot/EFI/BOOT/grubx64.efi /boot/EFI/BOOT/BOOTX64.EFI

You can also check the boot entry with efibootmgr

efibootmgr | cut -f 1

5. It's done...

Now it's done and we can finally reboot to the installed system. With encryption you will be asked for the LUKS passphrase before the system boots.

Nothing else is needed in the live environment - the optional TPM2 auto-unlock is set up after the first boot, on the installed system (see section 6).

exit
cd /
umount -a
reboot

6. Optional: TPM2 auto-unlock (after first boot)

With a TPM 2.0 chip the disk can unlock itself at boot - no passphrase typing. Run this on the installed system, after the first boot (not in the live environment). The existing passphrase slot stays in the LUKS header as a fallback, so this only adds another way to unlock:

sudo pacman -S tpm2-tss
sudo systemd-cryptenroll --tpm2-device=auto /dev/sda2

Notes:

  • Without Secure Boot the TPM binding is machine-bound only - it protects against a casual boot of the machine, not against a targeted attacker with physical access.
  • After a firmware change (BIOS update, motherboard swap) the TPM unlock stops working - unlock with the passphrase and enroll again.
  • Don't run systemd-cryptenroll --wipe-slot=password - it would remove the passphrase fallback.