Tomster/Arch-Setup-Script
1
0
Fork 0
mirror of https://github.com/tommytran732/Arch-Setup-Script synced 2024-12-26 16:52:16 -05:00
Code
Setting up Arch Linux with BTRFS, snapshots and full disk encryption including /boot (UEFI only).
458 Commits 1 Branch 0 Tags 1.7 MiB
Shell 100%
d710acdaf8
Go to file
funk-on-code d710acdaf8
Fix erroneous 'tee' for sshd custom configuration. (#38) 
Generation of sshd_config.d doesn't.

Instead, it makes /root/tee, because of a typo.

Signed-off-by: funk-on-code <113871227+funk-on-code@users.noreply.github.com>
2024-08-06 15:07:45 -07:00
.github Daily update for GitHub actions 2024-06-15 15:04:11 -07:00
etc/unbound Add unbound config for Docker 2024-06-24 18:23:48 -07:00
desktop_postinstall.sh Add set -u 2024-07-20 18:19:01 -07:00
install.sh Fix erroneous 'tee' for sshd custom configuration. (#38) 2024-08-06 15:07:45 -07:00
LICENSE Switch to Apache License 2023-03-17 08:26:13 -04:00
README.md Add highlighting for dirs 2024-06-01 15:23:55 -07:00
update_grub.sh Add set -u 2024-07-20 18:19:01 -07:00

README.md

Introduction

ShellCheck

This is my installer for Arch Linux. It sets up a BTRFS system with encrypted /boot and full snapper support (both snapshotting and rollback work!). It also includes various system hardening configurations.

The script is based on easy-arch. However, it diverges substantially from the original project does not follow its development.

Visit my Matrix group: https://invite.arcticfoxes.net/#/#tommy:arcticfoxes.net

How to use it?

  1. Download an Arch Linux ISO from here
  2. Flash the ISO onto an USB Flash Drive.
  3. Boot the live environment.
  4. Connect to the internet.
  5. git clone https://github.com/tommytran732/Arch-Setup-Script/
  6. cd Arch-Setup-Script
  7. chmod u+x ./install.sh
  8. ./install.sh

Snapper behavior

The partition layout I use allows us to replicate the behavior found in openSUSE 🦎

  1. Snapper rollback works! You will no longer need to manually rollback from a live USB like you would with the @ and @home layout suggested in the Arch Wiki.
  2. You can boot into a readonly snapshot! GDM and other services will start normally so you can get in and verify that everything works before rolling back.
  3. Automatic snapshots on pacman install/update/remove operations
  4. Directories such as /boot, /boot/efi, /var/log, /var/crash, /var/tmp, /var/spool, /var/lib/libvirt/images are excluded from the snapshots as they either should be persistent or are just temporary files. /cryptkey is excluded as we do not want the encryption key to be included in the snapshots, which could be sent to another device as a backup.
  5. GRUB will boot into the default BTRFS snapshot set by snapper. Like on openSUSE, your running system will always be a read-write snapshot in @/.snapshots/X/snapshot.

Security considerations

Since this is an encrypted /boot setup, GRUB will prompt you for your encryption password and decrypt the drive so that it can access the kernel and initramfs. I am unaware of any way to make it use a TPM + PIN setup.

The implication of this is that an attacker can change your secure boot state with a programmer, replace your grubx64.efi and it will not be detected until its too late.

This type of attack can theoratically be solved by splitting /boot out to a seperate partition and encrypt the root filesystem separately. The key protector for the root filesystem can then be sealed to a TPM with PCR 0+1+2+3+5+7+14. It is a bit more complicated to set up so my installer does not support this (yet!).