debian-buster-zfs-root icon indicating copy to clipboard operation
debian-buster-zfs-root copied to clipboard

Install Debian 10 (Buster) to a native ZFS root filesystem

debian-buster-zfs-root

Installs Debian GNU/Linux 10 Buster to a native ZFS root filesystem using a Debian Live CD. The resulting system is a fully updateable debian system with no quirks or workarounds.

Warning

Due to problems with grub-efi-amd64-signed UEFI secure boot has been disabled until a proper solution is available (SoerenBusse has created a fix which has not been reviewd yet).

Usage

  1. Boot Debian Live CD
  2. Login (user: user, password: live) and become root
  3. Setup network and export http_proxy environment variable (if needed)
  4. Run this script
  5. User interface: Select disks and RAID level
  6. User interface: Decide if you want Legacy BIOS or EFI boot (only if your hardware supports EFI)
  7. Let the installer do the work
  8. User interface: install grub to all disks participating in the array (only if you're using Legacy BIOS boot)
  9. User interface: enter root password and select timezone
  10. Reboot
  11. Star this repository :)

Fixes included

  • Some mountpoints, notably /var, need to be mounted via fstab as the ZFS mount script runs too late during boot.
  • The EFI System Partition (ESP) is a single point of failure on one disk, this is arguably a mis-design in the UEFI specification. This script installs an ESP partition to every RAID disk, accompanied with a corresponding EFI boot menu.

Bugs

  • grub-install sometimes mysteriously fails for disk numbers >= 4 (grub-install: error: cannot find a GRUB drive for /dev/disk/by-id/...).

Credits

  • https://github.com/hn/debian-stretch-zfs-root
  • https://github.com/zfsonlinux/zfs/wiki/Ubuntu-16.04-Root-on-ZFS
  • https://janvrany.github.io/2016/10/fun-with-zfs-part-1-installing-debian-jessie-on-zfs-root.html