diff --git a/docs/Getting Started/Debian/Debian Buster Root on ZFS.rst b/docs/Getting Started/Debian/Debian Buster Root on ZFS.rst index 728f078..1104211 100644 --- a/docs/Getting Started/Debian/Debian Buster Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Buster Root on ZFS.rst @@ -51,7 +51,9 @@ Contributing #. Install the tools:: sudo apt install python3-pip + pip3 install -r docs/requirements.txt + # Add ~/.local/bin to your $PATH, e.g. by adding this to ~/.bashrc: PATH=$HOME/.local/bin:$PATH @@ -117,6 +119,7 @@ Step 1: Prepare The Install Environment convenient:: sudo apt install --yes openssh-server + sudo systemctl restart ssh **Hint:** You can find your IP address with @@ -131,7 +134,9 @@ Step 1: Prepare The Install Environment apt install --yes debootstrap gdisk dkms dpkg-dev \ linux-headers-$(uname -r) + apt install --yes -t buster-backports --no-install-recommends zfs-dkms + modprobe zfs apt install --yes -t buster-backports zfsutils-linux @@ -304,6 +309,7 @@ Step 2: Disk Formatting - LUKS:: apt install --yes cryptsetup + cryptsetup luksFormat -c aes-xts-plain64 -s 512 -h sha256 ${DISK}-part4 cryptsetup luksOpen ${DISK}-part4 luks1 zpool create \ @@ -592,6 +598,7 @@ Step 4: System Configuration ln -s /proc/self/mounts /etc/mtab apt update + apt install --yes console-setup locales Even if you prefer a non-English system language, always ensure that @@ -602,7 +609,9 @@ Step 4: System Configuration #. Install ZFS in the chroot environment for the new system:: apt install --yes dpkg-dev linux-headers-amd64 linux-image-amd64 + apt install --yes zfs-initramfs + echo REMAKE_INITRD=yes > /etc/dkms/zfs.conf #. For LUKS installs only, setup ``/etc/crypttab``:: @@ -632,6 +641,7 @@ Step 4: System Configuration - Install GRUB for UEFI booting:: apt install dosfstools + mkdosfs -F 32 -s 1 -n EFI ${DISK}-part2 mkdir /boot/efi echo /dev/disk/by-uuid/$(blkid -s UUID -o value ${DISK}-part2) \ @@ -1012,6 +1022,7 @@ Go through `Step 1: Prepare The Install Environment For LUKS, first unlock the disk(s):: apt install --yes cryptsetup + cryptsetup luksOpen /dev/disk/by-id/scsi-SATA_disk1-part4 luks1 # Repeat for additional disks, if this is a mirror or raidz topology. diff --git a/docs/Getting Started/Debian/Debian Stretch Root on ZFS.rst b/docs/Getting Started/Debian/Debian Stretch Root on ZFS.rst index 0438524..28ecc7b 100644 --- a/docs/Getting Started/Debian/Debian Stretch Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Stretch Root on ZFS.rst @@ -55,7 +55,9 @@ Contributing #. Install the tools:: sudo apt install python3-pip + pip3 install -r docs/requirements.txt + # Add ~/.local/bin to your $PATH, e.g. by adding this to ~/.bashrc: PATH=$HOME/.local/bin:$PATH diff --git a/docs/Getting Started/Ubuntu/Ubuntu 18.04 Root on ZFS.rst b/docs/Getting Started/Ubuntu/Ubuntu 18.04 Root on ZFS.rst index 799b796..d60cd8c 100644 --- a/docs/Getting Started/Ubuntu/Ubuntu 18.04 Root on ZFS.rst +++ b/docs/Getting Started/Ubuntu/Ubuntu 18.04 Root on ZFS.rst @@ -56,7 +56,9 @@ Contributing #. Install the tools:: sudo apt install python3-pip + pip3 install -r docs/requirements.txt + # Add ~/.local/bin to your $PATH, e.g. by adding this to ~/.bashrc: PATH=$HOME/.local/bin:$PATH diff --git a/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS for Raspberry Pi.rst b/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS for Raspberry Pi.rst index 81bc02f..e44347a 100644 --- a/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS for Raspberry Pi.rst +++ b/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS for Raspberry Pi.rst @@ -53,7 +53,9 @@ Contributing #. Install the tools:: sudo apt install python3-pip + pip3 install -r docs/requirements.txt + # Add ~/.local/bin to your $PATH, e.g. by adding this to ~/.bashrc: PATH=$HOME/.local/bin:$PATH @@ -232,6 +234,7 @@ Step 2: Setup ZFS #. Install ZFS:: apt update + apt install pv zfs-initramfs **Note:** Since this is the first boot, you may get ``Waiting for cache diff --git a/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst b/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst index 16d8b65..7ff954e 100644 --- a/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst +++ b/docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst @@ -183,7 +183,9 @@ Contributing #. Install the tools:: sudo apt install python3-pip + pip3 install -r docs/requirements.txt + # Add ~/.local/bin to your $PATH, e.g. by adding this to ~/.bashrc: PATH=$HOME/.local/bin:$PATH @@ -258,6 +260,7 @@ Step 1: Prepare The Install Environment #. Install ZFS in the Live CD environment:: apt install --yes debootstrap gdisk zfs-initramfs + systemctl stop zed Step 2: Disk Formatting @@ -710,6 +713,7 @@ Step 4: System Configuration Install your preferred text editor:: apt install --yes nano + apt install --yes vim Installing the full ``vim`` package fixes terminal problems that occur when @@ -818,6 +822,7 @@ Step 4: System Configuration - For an unencrypted mirror or raidz topology:: apt install --yes mdadm + # Adjust the level (ZFS raidz = MD raid5, raidz2 = raid6) and # raid-devices if necessary and specify the actual devices. mdadm --create /dev/md0 --metadata=1.2 --level=mirror \ @@ -829,6 +834,7 @@ Step 4: System Configuration - For an encrypted (LUKS or ZFS native encryption) single-disk install:: apt install --yes cryptsetup + echo swap ${DISK}-part2 /dev/urandom \ swap,cipher=aes-xts-plain64:sha256,size=512 >> /etc/crypttab echo /dev/mapper/swap none swap defaults 0 0 >> /etc/fstab @@ -837,6 +843,7 @@ Step 4: System Configuration topology:: apt install --yes cryptsetup mdadm + # Adjust the level (ZFS raidz = MD raid5, raidz2 = raid6) and # raid-devices if necessary and specify the actual devices. mdadm --create /dev/md0 --metadata=1.2 --level=mirror \