From 73d8446bedcbedd7d5ba48efacaebb2879e222b6 Mon Sep 17 00:00:00 2001 From: Tommaso Chiti Date: Sun, 29 May 2022 15:01:01 +0200 Subject: [PATCH] Clarity. --- README.md | 30 +++++++++++++----------------- 1 file changed, 13 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 254dc1f..3ad473c 100644 --- a/README.md +++ b/README.md @@ -3,13 +3,12 @@ ![](https://img.shields.io/github/forks/classy-giraffe/easy-arch?label=Forks) ### Introduction -[easy-arch](https://github.com/classy-giraffe/easy-arch) is a **bash script** made in order to install **Arch Linux** and configure it with proper settings (while keeping it vanilla): +[easy-arch](https://github.com/classy-giraffe/easy-arch) is a **bash script** that boostraps **Arch Linux** and configures it: 1. BTRFS bootable snapshots from GRUB 2. LUKS2 encryption 3. [ZRAM](https://fedoraproject.org/wiki/Changes/SwapOnZRAM) as swap 4. [systemd-oomd](https://fedoraproject.org/wiki/Changes/EnableSystemdOomd) 5. Autodetect VMs and provide guest tools (if available) -6. Sane defaults ### How does it work? 1. Download an Arch Linux ISO from [here](https://archlinux.org/download/) @@ -17,25 +16,31 @@ 3. Boot the live environment 4. Set the keyboard layout by using `loadkeys ` 5. Connect to the internet -6. Run either one of these (always check twice before piping script into bash): +6. Run either one of these (always check twice before piping internet downloaded scripts into bash): ``` -bash <(curl -s https://raw.githubusercontent.com/classy-giraffe/easy-arch/main/easy-arch.sh) +Short version: bash <(curl -sL bit.ly/easy-arch) ``` +``` +Long version: +bash <(curl -s https://raw.githubusercontent.com/classy-giraffe/easy-arch/main/easy-arch.sh) +``` ### Partitions layout +The **partitions layout** is simple and it consists of only two partitions: +1. A **FAT32** partition (512MiB), mounted at `/boot/` as ESP. +2. A **LUKS2 encrypted container**, which takes the rest of the disk space, mounted at `/` as root. + | Partition Number | Label | Size | Mountpoint | Filesystem | |------------------|-----------|-------------------|----------------|-------------------------| | 1 | ESP | 512 MiB | /boot/ | FAT32 | | 2 | Cryptroot | Rest of the disk | / | BTRFS Encrypted (LUKS2) | -The **partitions layout** is simple and it's inspired by [this section](https://wiki.archlinux.org/index.php/Dm-crypt/Encrypting_an_entire_system#Btrfs_subvolumes_with_swap) of the Arch Linux Wiki. As you can see there're only two partitions: -1. A **FAT32**, 512MiB sized, mounted at `/boot/` for the ESP. -2. A **LUKS2 encrypted container**, which takes the rest of the disk space, mounted at `/` for the rootfs. - ### BTRFS subvolumes layout +The **BTRFS subvolumes layout** follows the traditional and suggested layout used by **Snapper**, you can find it [here](https://wiki.archlinux.org/index.php/Snapper#Suggested_filesystem_layout). + | Subvolume Number | Subvolume Name | Mountpoint | |------------------|----------------|-------------------------------| | 1 | @ | / | @@ -45,12 +50,3 @@ The **partitions layout** is simple and it's inspired by [this section](https:// | 5 | @snapshots | /.snapshots | | 6 | @var_log | /var/log | | 7 | @var_pkgs | /var/cache/pacman/pkg | - -The **BTRFS subvolumes layout** follows the traditional and suggested layout used by **Snapper**, you can find it [here](https://wiki.archlinux.org/index.php/Snapper#Suggested_filesystem_layout). Here's a brief explanation of the **BTRFS layout** I chose: -1. `@` mounted at `/` -2. `@home` mounted at `/home` -3. `@root` mounted at `/root` -4. `@srv` mounted at `/srv` -5. `@snapshots` mounted at `/.snapshots` -6. `@var_log` mounted at `/var/log` -7. `@var_pkgs` mounted at `/var/cache/pacman/pkg`