Compare commits

..

No commits in common. "5920fb3b2e6c462a1cd19cf675bccc2b83f2296e" and "077aec5d56d6096ee2030d6d9a81d8969d19a44c" have entirely different histories.

564
README.md
View file

@ -1,480 +1,260 @@
# ArchLinux install encrypted btrfs
# Install Arch Linux on EFI system with full filesystem (including /boot) encrypted and on btrfs partition
Official guide for basic install: [https://wiki.archlinux.org/index.php/Installation\_Guide](https://wiki.archlinux.org/index.php/Installation_Guide)
# Install Arch Linux with encrypted filesystem(optional) and on btrfs partition (UEFI)
Official guide for basic install: [https://wiki.archlinux.org/index.php/Installation_Guide](https://wiki.archlinux.org/index.php/Installation_Guide)
it is always good to consult with official guide, cause arch config might change in time
For setting up different locale, or better explanations check out Arch Wiki
For setting up different locale than pl check official guide
## 1. Boot ISO
# 1. Boot ISO
### Download the ISO file from [https://www.archlinux.org](https://www.archlinux.org/)
### Put on pedrive
>dd if=archlinux.img of=/dev/sdX bs=16M && sync
#### Download the ISO file from [https://www.archlinux.org](https://www.archlinux.org/)
### Boot from the usb.
#### Put on pendrive
### Set keymap
>loadkeys pl
```bash
dd if=archlinux.img of=/dev/sdX bs=16M && sync
```
### Update clock
>timedatectl set-ntp true
#### Boot from the USB.
### Optionally (recommended) update mirrorlist
>reflector --country 'Poland' --age 24 --verbose --sort rate --save /etc/pacman.d/mirrorlist
#### Optional (**experimental** approach to have desktop environment during install):
# 2. Prepare Disk
##### Extend writable space so you can install basic desktop in live environment and for example use gparted for partitioning or open this tutorial in web browser or whatever you want.
### Update btrfs-progs
>pacman -Syy btrfs-progs
<p class="callout warning">Remember this area is saved in your RAM, so make sure you have enough of it</p>
```
mount -o remount,size=5G /run/archiso/cowspace
pacman -Syy plasma-desktop glibc konsole xorg
pacman -Scc
startplasma-wayland
```
#### Set key map
```bash
loadkeys pl
```
#### Update clock
```bash
timedatectl set-ntp true
```
#### Optionally (recommended) update mirrorlist
```bash
reflector --country 'Poland' --age 24 --verbose --sort rate --save /etc/pacman.d/mirrorlist
```
## 2. Prepare Disk
#### Update btrfs-progs
```bash
pacman -Syy btrfs-progs
```
#### Display disks and partitions
```bash
lsblk
```
#### Create partitions (if you have not already)
```bash
fdisk /dev/sdX
```
### Display disks setup
>fdisk -l
### Create partitions (if you have not already)
>fdisk /dev/sdX
1. 100MB EFI partition
2. 100% size partiton # ( encrypted optionally) for BTRFS partition, this partition will require formatting AFTER encryption if you do encryption
2. 100% size partiton # ( encrypted optionally) for BTRFS, this partition will require formatting AFTER encryption if you do encryption
### Swap will be as file in its own subvolume
##### Swap will bin in file with CoW disabled, which will be prepared later
>mkfs.vfat -F32 /dev/sdX1
#### Format EFI partition
### ----------------- encryption (optional) ------------------
```Bash
mkfs.vfat -F32 /dev/sdX1
```
### Setup the encryption of the system, don't use letters outside en-us keyboard like ąęć etc. for password
### Grub have partial support for luks2 now, but can handle only pbkdf2
>cryptsetup -c=aes-xts-plain64 --key-size=512 --hash=sha512 --iter-time=3000 --pbkdf=pbkdf2 --use-random luksFormat --type=luks2 /dev/sdX2
##### ----------------- encryption (optional) ------------------
#### Setup the encryption of the system,
<p class="callout info">Don't use regional letters (not in en-us keyboard) like ąęć etc. for password. This requires additional steps, which are not covered by this tutorial.</p>
#### Grub have some kind of support for luks2, but not entirely, so for more fail-safe setup use luks1
```bash
cryptsetup -c=aes-xts-plain64 --key-size=512 --hash=sha512 --iter-time=3000 --pbkdf=pbkdf2 --use-random luksFormat --type=luks1 /dev/sdX2
cryptsetup luksOpen /dev/sdX2 MainPart
```
>cryptsetup luksOpen /dev/sdX2 MainPart
### Formatting as btrfs now when it is already encrypted
>mkfs.btrfs -L "Arch Linux" /dev/mapper/MainPart
```bash
mkfs.btrfs -L "Arch Linux" /dev/mapper/MainPart
```
##### ---------------- end of encryption ------------------------
### ---------------- end of encryption ------------------------
#### Format the partition if not yet formatted:
### Format the partition if not yet formatted:
>pacman -Syy btrfs-progs
```bash
pacman -Syy btrfs-progs
>mkfs.btrfs -L "Arch Linux" /dev/sdX2
mkfs.btrfs -L "Arch Linux" /dev/sdX2
```
### Mount partition to be able to create btrfs subvolumes
### If using encryption, change /dev/sdX2 to /dev/mapper/MainPart:
>mount /dev/sdX2 /mnt
#### Mount partition to be able to create btrfs subvolumes
## Create subvolumes
### Using more complicated sheme, (but there actually is only need for separate @swap subvolume , other files can be on default top subvolume)
##### If using encryption, change **/dev/sdX2** to **/dev/mapper/MainPart**:
>btrfs su cr /mnt/@
```bash
mount /dev/sdX2 /mnt
```
>btrfs su cr /mnt/@swap
#### Create subvolumes
>btrfs su cr /mnt/@home
##### This scheme can be adjusted to your needs, I'd suggest at least one subvolume for root (@) and one for snapshots (@snapshots). varlog and tmp are created to easily disable Copy on Write on` /var/log` and `/tmp`.
>btrfs su cr /mnt/@var
```bash
btrfs su cr /mnt/@
>btrfs su cr /mnt/@tmp
btrfs su cr /mnt/@home
>btrfs su cr /mnt/@snapshots
btrfs su cr /mnt/@varlog
#### disable copy on write on var, tmp and swap
>chattr +C /mnt/@var
>chattr +C /mnt/@tmp
>chattr +C /mnt/@swap
btrfs su cr /mnt/@tmp
>umount /mnt
btrfs su cr /mnt/@snapshots
### If using encryption, change /dev/sdX2 to /dev/mapper/MainPart:
>mount -o defaults,noatime,discard,ssd,subvol=@ /dev/sdX2 /mnt
```
>mkdir /mnt/swap
##### Disable copy on write on `/var/log` and `/tmp`
>mkdir /mnt/home
```bash
chattr +C /mnt/@varlog
chattr +C /mnt/@tmp
umount /mnt
>mkdir /mnt/var
```
>mkdir /mnt/tmp
#### If using encryption, change **/dev/sdX2** to **/dev/mapper/MainPart**:
>mkdir /mnt/snapshots
```bash
mount -o defaults,noatime,discard,ssd,subvol=@ /dev/sdX2 /mnt
>mkdir /mnt/efi # for EFI partition /dev/sdX1
mkdir /mnt/home
### If using encryption, change /dev/sdX2 to /dev/mapper/MainPart
### for swap subvolume add nodatacow option to disable CoW (works only if its separate partition)
### Discard ssd and noatime are for ssd disks only
mkdir -p /mnt/var/log
>mount -o defaults,noatime,nodatacow,discard,ssd,subvol=@swap /dev/sdX2 /mnt/swap
mkdir /mnt/tmp
>mount -o defaults,noatime,discard,ssd,subvol=@home /dev/sdX2 /mnt/home
mkdir /mnt/snapshots
>mount -o defaults,noatime,discard,ssd,subvol=@var /dev/sdX2 /mnt/var
mkdir /mnt/efi # for EFI partition /dev/sdX1
```
>mount -o defaults,noatime,discard,ssd,subvol=@tmp /dev/sdX2 /mnt/tmp
#### Discard and ssd options and are for ssd disks only
>mount -o defaults,noatime,discard,ssd,subvol=@snapshots /dev/sdX2 /mnt/snapshots
#### If using encryption, change **/dev/sdX2** to **/dev/mapper/MainPart**
>mount /dev/sdX1 /mnt/efi
```bash
mount -o defaults,noatime,discard,ssd,subvol=@home /dev/sdX2 /mnt/home
mount -o defaults,noatime,discard,ssd,subvol=@varlog /dev/sdX2 /mnt/var/log
# 3. Install Arch Linux
mount -o defaults,noatime,discard,ssd,subvol=@tmp /dev/sdX2 /mnt/tmp
### Select the mirror to be used if not updated with reflector on start
>nano /etc/pacman.d/mirrorlist
mount -o defaults,noatime,discard,ssd,subvol=@snapshots /dev/sdX2 /mnt/snapshots
### This command can be customized with additional packages
>pacstrap /mnt/ base base-devel git btrfs-progs efibootmgr linux linux-headers linux-firmware mkinitcpio dhcpcd bash-completion sudo
mount /dev/sdX1 /mnt/efi
```
### Use genfstab with -U parameter if no encryption
>genfstab /mnt >> /mnt/etc/fstab
# 3. Install Arch Linux
### If using swapfile check if nodatacow is added for @swap
>nano /mnt/etc/fstab
#### Select the mirror to be used if not updated with reflector on start
```bash
vim /etc/pacman.d/mirrorlist
```
#### Install base system:
##### This command can be customized with additional packages (**btrfs-progs is necessary to let the system boot up from btrfs partition !**)
```bash
pacstrap /mnt/ base base-devel git btrfs-progs efibootmgr linux linux-headers linux-firmware mkinitcpio dhcpcd bash-completion sudo
```
#### Generate fstab:
##### Use genfstab with -U parameter if no encryption
```bash
genfstab /mnt >> /mnt/etc/fstab
```
####
# 4. Configure the system
#### Switch to installed system root user
### Switch to installed system root user
>arch-chroot /mnt /bin/bash
```bash
arch-chroot /mnt /bin/bash
```
### Nano can be usefull when editing config files
>pacman -Syy nano
#### Setup system clock
### Setup system clock
>ln -s /usr/share/zoneinfo/Europe/Warsaw /etc/localtime
```bash
ln -s /usr/share/zoneinfo/Europe/Warsaw /etc/localtime
>hwclock --systohc --utc
hwclock --systohc --utc
```
### Set the hostname
>/etc/hostname
>>myhostname
#### Set the hostname in `/etc/hostname`
### Edit vconsole
>/etc/vconsole.conf
>>KEYMAP=pl
>>FONT=Lat2-Terminus16.psfu.gz
>>FONT_MAP=8859-2
```test
myhostname
```
### Setup locale
### Uncomment pl_PL.UTF-8 in /etc/locale.gen and then:
>locale-gen
#### Edit vconsole in `/etc/vconsole.conf`
### Update locale
>/etc/locale.conf
>>LANG=pl_PL.UTF-8
>>LC_ALL=pl_PL.UTF-8
```text
KEYMAP=pl
FONT=Lat2-Terminus16.psfu.gz
FONT_MAP=8859-2
### Hosts
>/etc/hosts
>>127.0.0.1 localhost
>>::1 localhost
>>127.0.1.1 myhostname.localdomain myhostname
```
### Now create 4GiB swap file. nodatacow is already on @swap but if you follow exactly then @swap is on same partition as other subvolumes and nodatacow will not work for whole subvolume so you need to disavle CoW manualy :
>touch /swap/swapfile
### Check if C attribute is enabled with
>lsattr /swap/swapfile'
#### Setup locale
### If not then disable COW for swapfile manually:
>chattr +C /swap/swapfile
##### Uncomment pl\_PL.UTF-8 in /etc/locale.gen and then run:
### Expanding empty file to 4GiB swap file
>dd if=/dev/zero of=/swap/swapfile bs=1024K count=4096
```bash
locale-gen
```
>chmod 600 /swap/swapfile
#### Update locale in `etc/locale.conf`
### Format the swap file.
>mkswap /swap/swapfile
```text
LANG=en_US.UTF-8
LC_COLLATE=pl_PL.UTF-8
LC_MEASUREMENT=pl_PL.UTF-8
LC_MONETARY=pl_PL.UTF-8
LC_NUMERIC=pl_PL.UTF-8
LC_TIME=pl_PL.UTF-8
### Turn swap file on.
>swapon /swap/swapfile
```
### You also need to update /etc/fstab to mount swapfile on boot:
>/etc/fstab
>>/swap/swapfile none swap sw 0 0
#### Hosts in `/etc/hosts`
### Set password for root
>passwd
### Add real user
>useradd -m MYUSERNAME
```text
127.0.0.1 localhost
::1 localhost
127.0.1.1 myhostname.localdomain myhostname
```
#### Now create empty (with 0 size) swap file:
#### Create separate subvolume for swapfile. This subvolume is needed to let you make snapshot of `/`, which would not be possible with any file in it with CoW disabled!
```
btrfs su create /swap
chattr +C /swap
```
#### Copy on Write should always be disabled on swap file, so it will be done in the next step
```bash
touch /swap/swapfile
```
#### Check if C attribute is enabled (should be already if created in folder with disabled CoW attribute)
```bash
lsattr /swap/swapfile'
```
#### If not then disable CoW for swapfile manually:
```bash
chattr +C /swap/swapfile
```
#### Expanding empty file to 4GiB swap file
```bash
dd if=/dev/zero of=/swap/swapfile bs=1024K count=4096
chmod 600 /swap/swapfile
```
#### Format the swap file.
```bash
mkswap /swap/swapfile
```
#### Turn swap file on.
```bash
swapon /swap/swapfile
```
#### You also need to update `/etc/fstab` to mount swapfile on boot:
```text
/swap/swapfile none swap sw 0 0
```
#### Set password for root
```bash
passwd
```
#### Add real user an set password for him
```bash
useradd -m MYUSERNAME
passwd MYUSERNAME
```
>passwd MYUSERNAME
### Configure mkinitcpio with modules needed for the initrd image
>nano /etc/mkinitcpio.conf
### Remove 'fsck' and add 'keyboard', 'keymap', 'encrypt' and 'btrfs' to HOOKS before filesystems
### If no encryption then only remove fsck and add on that place btrfs
>HOOKS=(... keyboard keymap block encrypt btrfs ... filesystems ...)
```bash
vim /etc/mkinitcpio.conf
```
###### optionally add BINARIES=(/usr/bin/btrfs) for rescue?
#### Add 'keyboard', 'keymap', 'encrypt' and 'btrfs' to HOOKS before filesystems:
### Regenerate initrd images
>mkinitcpio -P
```
HOOKS=(base udev autodetect keyboard keymap modconf block btrfs filesystems keyboard fsck)
```
# 5. Install bootloader
#### Add btrfsck to binaries:
### Setup grub (UEFI)
>pacman -S grub efibootmgr os-prober dosfstools mtools
```
BINARIES=(btrfsck)
```
#### **With encryption:** also add encrypt before btrfs:
### -------------encryption only---------------------
>nano /etc/default/grub
>>GRUB_ENABLE_CRYPTODISK=y
### Find UUID (PARTUUID for /dev/sdX2) of crypto partition so we can add it to grub config
>blkid
### Now set this line including proper UUID in place of "\<device-UUID>":
####(temporarly you cen use /dev/sdX2 in place of UUID and change it later easy in gui mode)
>/etc/default/grub
>>GRUB_CMDLINE_LINUX="cryptdevice=UUID=\<device-UUID>:MainPart:allow-discards
### allow-discards is only for ssd
```text
HOOKS=(... keyboard keymap block encrypt btrfs ... filesystems ...)
```
### Generate key so grub don't ask twice for password on boot
>dd bs=512 count=4 if=/dev/random of=/crypto_keyfile.bin iflag=fullblock
>chmod 600 /crypto_keyfile.bin
>chmod 600 /boot/initramfs-linux*
>cryptsetup luksAddKey /dev/sdX2 /crypto_keyfile.bin
### If you change name of key file there is need to add kernel parameter like cryptkey=rootfs:path
### Crypto_keyfile.bin is the default name that kernel will guess anyway
### Now add this file to mkinitcpio.conf
>/etc/mkinitcpio.conf
>>FILES=(/crypto_keyfile.bin)
######
>mkinitcpio -P
### -------------encryption end---------------------
#### Regenerate initrd images
### Install
>grub-install --target=x86_64-efi --efi-directory=/efi --bootloader-id=GRUB
>grub-mkconfig -o /boot/grub/grub.cfg
```bash
mkinitcpio -P
```
### Exit new system
>exit
# 5. Install bootloader
### Unmount all partitions
>swapoff -a
>umount -R /mnt
#### Setup grub (UEFI)
### Reboot into the new system, don't forget to remove the CD/pendrive
>reboot
### or
>shutdown now
```bash
pacman -S grub efibootmgr os-prober dosfstools mtools
```
#### -------------encryption only---------------------
#### edit `/etc/default/grub`
```text
GRUB_ENABLE_CRYPTODISK=y
```
#### Find UUID (UUID for /dev/sdX2) of crypto partition so we can add it to grub config
```bash
blkid
```
#### Now set this line including proper UUID in place of "&lt;device-UUID&gt;":
#### (temporarly you can use /dev/sdX2 in place of "UUID=&lt;device-UUID&gt;" and change it later easy in gui mode)
##### edit `/etc/default/grub`
```text
GRUB_CMDLINE_LINUX="cryptdevice=UUID=<device-UUID>:MainPart:allow-discards"
```
##### allow-discards is only for ssd to let trim work with encryption enabled
#### Generate key so grub don't ask twice for password on boot
```bash
dd bs=512 count=4 if=/dev/random of=/crypto_keyfile.bin iflag=fullblock
chmod 600 /crypto_keyfile.bin
chmod 600 /boot/initramfs-linux*
cryptsetup luksAddKey /dev/sdX2 /crypto_keyfile.bin
```
#### If you change name of key file there is need to add kernel parameter like cryptkey=rootfs:path
#### Crypto\_keyfile.bin is the default name that kernel will guess anyway
#### Now add this file to `/etc/mkinitcpio.conf`
```text
FILES=(/crypto_keyfile.bin)
```
then run:
```bash
mkinitcpio -P
```
#### -------------encryption end---------------------
#### Install grub for
```bash
grub-install --target=x86_64-efi --efi-directory=/efi --bootloader-id=GRUB
grub-mkconfig -o /boot/grub/grub.cfg
```
#### Exit new system
```bash
exit
```
#### Unmount all partitions
```bash
swapoff -a
umount -R /mnt
```
#### Reboot into the new system, don't forget to remove the pendrive
```bash
reboot
```
#### or
```bash
shutdown now
```
### 6. Addtitional tips:
#### Install AUR helper (git and base-devel packages needed to do so):
```
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
```
#### To get proper locale and keymap, check:
```bash
localectl status
```
#### On KDE plasma , also set settings &gt; ... &gt; keyboard layout &amp;&amp; regional settings
## Addtitional tips
### To get proper locale and keymap, check:
>localectl status
### On KDE plasma , also set settings > ... > keyboard layout && regional settings