Root on ZFS: mention ZFSBootMenu (#467)

Signed-off-by: Yǔchēn Guō 郭宇琛 <[email protected]>
openzfs · Oct 29, 2023 · aa0b4fa · aa0b4fa
1 parent 16cfd12
commit aa0b4fa
Show file tree

Hide file tree

Showing 4 changed files with 51 additions and 0 deletions.
diff --git a/docs/Getting Started/Alpine Linux/Root on ZFS.rst b/docs/Getting Started/Alpine Linux/Root on ZFS.rst
@@ -22,6 +22,18 @@ Alpine Linux Root on ZFS
     apk update
     apk add alpine-conf curl
 
+**ZFSBootMenu**
+
+This tutorial is based on the GRUB bootloader.  Due to its independent
+implementation of a read-only ZFS driver, GRUB only supports a subset
+of ZFS features on the boot pool. [In general, bootloader treat disks
+as read-only to minimize the risk of damaging on-disk data.]
+
+`ZFSBootMenu <https://zfsbootmenu.org>`__ is an alternative bootloader
+free of such limitations and has support for boot environments. Do not
+follow instructions on this page if you plan to use ZBM,
+as the layouts are not compatible.  Refer
+to their site for installation details.
 
 **Customization**
 

diff --git a/docs/Getting Started/Arch Linux/Root on ZFS.rst b/docs/Getting Started/Arch Linux/Root on ZFS.rst
@@ -27,6 +27,19 @@
 Arch Linux Root on ZFS
 =======================================
 
+**ZFSBootMenu**
+
+This tutorial is based on the GRUB bootloader.  Due to its independent
+implementation of a read-only ZFS driver, GRUB only supports a subset
+of ZFS features on the boot pool. [In general, bootloader treat disks
+as read-only to minimize the risk of damaging on-disk data.]
+
+`ZFSBootMenu <https://zfsbootmenu.org>`__ is an alternative bootloader
+free of such limitations and has support for boot environments. Do not
+follow instructions on this page if you plan to use ZBM,
+as the layouts are not compatible.  Refer
+to their site for installation details.
+
 **Customization**
 
 Unless stated otherwise, it is not recommended to customize system

diff --git a/docs/Getting Started/Fedora/Root on ZFS.rst b/docs/Getting Started/Fedora/Root on ZFS.rst
@@ -28,6 +28,19 @@
 Fedora Root on ZFS
 =======================================
 
+**ZFSBootMenu**
+
+This tutorial is based on the GRUB bootloader.  Due to its independent
+implementation of a read-only ZFS driver, GRUB only supports a subset
+of ZFS features on the boot pool. [In general, bootloader treat disks
+as read-only to minimize the risk of damaging on-disk data.]
+
+`ZFSBootMenu <https://zfsbootmenu.org>`__ is an alternative bootloader
+free of such limitations and has support for boot environments. Do not
+follow instructions on this page if you plan to use ZBM,
+as the layouts are not compatible.  Refer
+to their site for installation details.
+
 **Customization**
 
 Unless stated otherwise, it is not recommended to customize system

diff --git a/docs/Getting Started/RHEL-based distro/Root on ZFS.rst b/docs/Getting Started/RHEL-based distro/Root on ZFS.rst
@@ -25,6 +25,19 @@
 Rocky Linux Root on ZFS
 =======================================
 
+**ZFSBootMenu**
+
+This tutorial is based on the GRUB bootloader.  Due to its independent
+implementation of a read-only ZFS driver, GRUB only supports a subset
+of ZFS features on the boot pool. [In general, bootloader treat disks
+as read-only to minimize the risk of damaging on-disk data.]
+
+`ZFSBootMenu <https://zfsbootmenu.org>`__ is an alternative bootloader
+free of such limitations and has support for boot environments. Do not
+follow instructions on this page if you plan to use ZBM,
+as the layouts are not compatible.  Refer
+to their site for installation details.
+
 **Customization**
 
 Unless stated otherwise, it is not recommended to customize system