From a4043503864478e2387b1b4ccaa5a02e11d0094e Mon Sep 17 00:00:00 2001 From: Christos Longros Date: Mon, 11 May 2026 09:42:46 +0200 Subject: [PATCH] Add Secure Boot warning to Debian, Ubuntu, and NixOS root guides Other Root-on-ZFS guides already note that ZFS modules cannot load with Secure Boot enabled (Fedora, Alpine, RHEL-based, Arch). The Debian, Ubuntu, and NixOS guides did not. Closes #493 Signed-off-by: Christos Longros --- docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst | 1 + docs/Getting Started/Debian/Debian Bullseye Root on ZFS.rst | 1 + docs/Getting Started/Debian/Debian Buster Root on ZFS.rst | 1 + docs/Getting Started/Debian/Debian Trixie Root on ZFS.rst | 1 + docs/Getting Started/NixOS/Root on ZFS.rst | 1 + docs/Getting Started/Ubuntu/Ubuntu 20.04 Root on ZFS.rst | 1 + docs/Getting Started/Ubuntu/Ubuntu 22.04 Root on ZFS.rst | 1 + 7 files changed, 7 insertions(+) diff --git a/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst b/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst index 62f78858b..b78263fc9 100644 --- a/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst @@ -104,6 +104,7 @@ encrypted once per disk. Step 1: Prepare The Install Environment --------------------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Boot the Debian GNU/Linux Live CD. If prompted, login with the username ``user`` and password ``live``. Connect your system to the Internet as appropriate (e.g. join your WiFi network). Open a terminal. diff --git a/docs/Getting Started/Debian/Debian Bullseye Root on ZFS.rst b/docs/Getting Started/Debian/Debian Bullseye Root on ZFS.rst index 1b0403e92..4326a7a22 100644 --- a/docs/Getting Started/Debian/Debian Bullseye Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Bullseye Root on ZFS.rst @@ -104,6 +104,7 @@ encrypted once per disk. Step 1: Prepare The Install Environment --------------------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Boot the Debian GNU/Linux Live CD. If prompted, login with the username ``user`` and password ``live``. Connect your system to the Internet as appropriate (e.g. join your WiFi network). Open a terminal. 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 58286af70..64ce87113 100644 --- a/docs/Getting Started/Debian/Debian Buster Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Buster Root on ZFS.rst @@ -103,6 +103,7 @@ encrypted once per disk. Step 1: Prepare The Install Environment --------------------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Boot the Debian GNU/Linux Live CD. If prompted, login with the username ``user`` and password ``live``. Connect your system to the Internet as appropriate (e.g. join your WiFi network). Open a terminal. diff --git a/docs/Getting Started/Debian/Debian Trixie Root on ZFS.rst b/docs/Getting Started/Debian/Debian Trixie Root on ZFS.rst index c31562957..57e461af7 100644 --- a/docs/Getting Started/Debian/Debian Trixie Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Trixie Root on ZFS.rst @@ -96,6 +96,7 @@ encrypted once per disk. Step 1: Prepare The Install Environment --------------------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Boot the Debian GNU/Linux Live CD. If prompted, login with the username ``user`` and password ``live``. Connect your system to the Internet as appropriate (e.g. join your WiFi network). Open a terminal. diff --git a/docs/Getting Started/NixOS/Root on ZFS.rst b/docs/Getting Started/NixOS/Root on ZFS.rst index 1444d0575..60a91271b 100644 --- a/docs/Getting Started/NixOS/Root on ZFS.rst +++ b/docs/Getting Started/NixOS/Root on ZFS.rst @@ -28,6 +28,7 @@ booted in UEFI mode. Preparation --------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Download `NixOS Live Image `__ and boot from it. 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 7e39cf4ee..1bcde6dbc 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 @@ -232,6 +232,7 @@ encrypted once per disk. Step 1: Prepare The Install Environment --------------------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Boot the Ubuntu Live CD. Select Try Ubuntu. Connect your system to the Internet as appropriate (e.g. join your WiFi network). Open a terminal (press Ctrl-Alt-T). diff --git a/docs/Getting Started/Ubuntu/Ubuntu 22.04 Root on ZFS.rst b/docs/Getting Started/Ubuntu/Ubuntu 22.04 Root on ZFS.rst index bf96b2575..301f3a3d5 100644 --- a/docs/Getting Started/Ubuntu/Ubuntu 22.04 Root on ZFS.rst +++ b/docs/Getting Started/Ubuntu/Ubuntu 22.04 Root on ZFS.rst @@ -111,6 +111,7 @@ encrypted once per disk. Step 1: Prepare The Install Environment --------------------------------------- +#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled. #. Boot the Ubuntu Live CD. From the GRUB boot menu, select *Try or Install Ubuntu*. On the *Welcome* page, select your preferred language and *Try Ubuntu*. Connect your system to the Internet as appropriate (e.g. join your WiFi network).