diff options
Diffstat (limited to 'PLAN-zfsbootmenu-implementation.org')
| -rw-r--r-- | PLAN-zfsbootmenu-implementation.org | 712 |
1 files changed, 0 insertions, 712 deletions
diff --git a/PLAN-zfsbootmenu-implementation.org b/PLAN-zfsbootmenu-implementation.org deleted file mode 100644 index 6733c26..0000000 --- a/PLAN-zfsbootmenu-implementation.org +++ /dev/null @@ -1,712 +0,0 @@ -#+TITLE: ZFSBootMenu Implementation Plan -#+AUTHOR: Craig Jennings & Claude -#+DATE: 2026-01-22 - -* Overview - -Replace GRUB bootloader with ZFSBootMenu in the archzfs installation script. ZFSBootMenu provides native ZFS snapshot booting, eliminates kernel/snapshot version mismatch issues, and simplifies the boot architecture. - -* Why ZFSBootMenu? - -| Feature | GRUB | ZFSBootMenu | -|-----------------+-----------------------------------+------------------------------| -| Snapshot boot | Custom scripts (grub-zfs-snap) | Native, built-in | -| Kernel location | Separate /boot partition | On ZFS with root | -| Rollback safety | Can mismatch kernel/snapshot | Kernel travels with snapshot | -| Boot menu | Regenerate with grub-mkconfig | Auto-discovers datasets | -| EFI size needed | ~1GB (kernels + GRUB) | ~64MB (single binary) | -| Complexity | High (scripts, hooks, generators) | Low (single binary + config) | - -* Current Architecture (GRUB) - -#+begin_example -EFI Partition (1GB, /boot): -├── EFI/ -│ └── GRUB/ -│ └── grubx64.efi -├── grub/ -│ ├── grub.cfg -│ └── fonts/ -├── vmlinuz-linux-lts -├── initramfs-linux-lts.img -└── initramfs-linux-lts-fallback.img - -ZFS Pool: -└── zroot/ - └── ROOT/ - └── default (mountpoint=/) -#+end_example - -* Target Architecture (ZFSBootMenu) - -#+begin_example -EFI Partition (512MB, /efi): -└── EFI/ - └── ZBM/ - └── zfsbootmenu.efi - -ZFS Pool: -└── zroot/ - └── ROOT/ (org.zfsbootmenu:commandline set here) - └── default (mountpoint=/) (bootfs property points here) - └── boot/ <-- regular directory, NOT a dataset! - ├── vmlinuz-linux-lts - ├── initramfs-linux-lts.img - └── initramfs-linux-lts-fallback.img -#+end_example - -*Key insight from research:* /boot is a regular directory inside ROOT/default, -NOT a separate ZFS dataset. This ensures: -1. Snapshots of ROOT/default include the matching kernel -2. Rolling back a snapshot also rolls back to the kernel that was installed at that time -3. ZFSBootMenu can find the kernel at the expected path - -* Files to Modify - -** custom/install-archzfs -Primary installation script - most changes here. - -** build.sh -ISO build script - remove GRUB snapshot tooling. - -** custom/grub-zfs-snap (DELETE) -No longer needed - ZFSBootMenu handles natively. - -** custom/40_zfs_snapshots (DELETE) -GRUB generator - no longer needed. - -** custom/zz-grub-zfs-snap.hook (DELETE) -Pacman hook for GRUB - no longer needed. - -** custom/zfssnapshot -Update to remove grub-zfs-snap call (ZFSBootMenu auto-detects). - -** custom/zfsrollback -Update to remove grub-zfs-snap call. - -* Implementation Steps - -** Step 1: Update partition_disks() - -Location: custom/install-archzfs, lines 707-750 - -Changes: -- Reduce EFI partition from 1GB to 512MB -- Update comments to reflect new purpose - -#+begin_src bash -# Change this line: -sgdisk -n 1:0:+1G -t 1:ef00 -c 1:"EFI" "$disk" - -# To: -sgdisk -n 1:0:+512M -t 1:ef00 -c 1:"EFI" "$disk" -#+end_src - -** Step 2: Update create_datasets() - -Location: custom/install-archzfs, lines 817-859 - -*CRITICAL: DO NOT create a separate /boot dataset!* - -From research (PandaScience, sandreas/zarch, ZFSBootMenu docs): -ZFSBootMenu expects /boot to be a *regular directory* inside the root dataset, -NOT a separate ZFS dataset. The kernels must live at the path /boot/* within -the root filesystem for ZFSBootMenu to find them. - -Changes: -- Do NOT create a /boot dataset -- The /boot directory will be created automatically by pacstrap when installing the kernel -- This ensures snapshots of ROOT/default include the matching kernel - -#+begin_src bash -# DO NOT ADD THIS - it's WRONG: -# zfs create -o mountpoint=/boot "$POOL_NAME/ROOT/default/boot" - -# /boot is just a regular directory inside ROOT/default -# mkinitcpio puts kernel/initramfs there automatically -#+end_src - -Note: With ZFSBootMenu, kernels live ON the root ZFS dataset (not EFI partition). -When you snapshot ROOT/default, the kernel is included in the snapshot. - -** Step 3: Replace mount_efi() - -Location: custom/install-archzfs, lines 861-867 - -Changes: -- Rename to mount_filesystems() -- Mount EFI at /efi instead of /boot -- /boot is already mounted as ZFS dataset - -#+begin_src bash -mount_filesystems() { - step "Mounting Filesystems" - - # EFI partition - only holds ZFSBootMenu binary - mkdir -p /mnt/efi - mount "${EFI_PARTS[0]}" /mnt/efi - info "EFI partition ${EFI_PARTS[0]} mounted at /mnt/efi" - - # /boot is a directory inside the ZFS root dataset (created by pacstrap) - # No separate mount needed - it's part of the root filesystem -} -#+end_src - -** Step 4: Update install_base() - -Location: custom/install-archzfs, lines 869-920 - -Changes: -- Remove: grub, freetype2 (GRUB font support) -- Keep: efibootmgr (needed for EFI boot entries) - -#+begin_src bash -# Remove these from pacstrap: -# grub \ -# freetype2 \ - -# Keep efibootmgr -#+end_src - -** Step 5: Update configure_system() fstab - -Location: custom/install-archzfs, lines 926-929 - -Changes: -- Mount EFI at /efi instead of /boot - -#+begin_src bash -# Change: -echo "UUID=$(blkid -s UUID -o value "${EFI_PARTS[0]}") /boot vfat defaults,noatime 0 2" - -# To: -echo "UUID=$(blkid -s UUID -o value "${EFI_PARTS[0]}") /efi vfat defaults,noatime 0 2" -#+end_src - -** Step 6: Update configure_initramfs() - -Location: custom/install-archzfs, lines 1021-1098 - -Changes: -- Update preset to use /boot (now on ZFS) -- No changes to hooks - ZFS hook still needed - -The preset file paths remain the same (/boot/vmlinuz-linux-lts, etc.) but /boot is now on ZFS instead of EFI partition. - -** Step 7: Replace configure_bootloader() with configure_zfsbootmenu() - -Location: custom/install-archzfs, lines 1100-1164 - -Delete the entire GRUB function and replace with: - -#+begin_src bash -configure_zfsbootmenu() { - step "Configuring ZFSBootMenu" - - # Ensure hostid exists and get value - # CRITICAL: Must be done BEFORE pool creation ideally, but we do it here too - if [[ ! -f /etc/hostid ]]; then - zgenhostid - fi - local host_id=$(hostid) - - # Copy hostid to installed system (ZFS uses this for pool ownership) - cp /etc/hostid /mnt/etc/hostid - - # Create ZFSBootMenu directory on EFI - mkdir -p /mnt/efi/EFI/ZBM - - # Download ZFSBootMenu release EFI binary - # Using the bundled release which includes everything needed - # (Alternative: build from AUR with generate-zbm, but this is simpler) - info "Downloading ZFSBootMenu..." - local zbm_url="https://get.zfsbootmenu.org/efi" - if ! curl -fsSL -o /mnt/efi/EFI/ZBM/zfsbootmenu.efi "$zbm_url"; then - error "Failed to download ZFSBootMenu" - fi - info "ZFSBootMenu binary installed." - - # Set kernel command line on the ROOT PARENT dataset - # This allows inheritance to all boot environments (future-proofing) - # ZFSBootMenu reads org.zfsbootmenu:commandline property - local cmdline="rw loglevel=3" - - # Add any AMD GPU workarounds if needed (detect Strix Halo etc) - if lspci | grep -qi "amd.*display\|amd.*vga"; then - info "AMD GPU detected - adding workaround parameters" - cmdline="$cmdline amdgpu.pg_mask=0 amdgpu.cwsr_enable=0" - fi - - # Set on ROOT parent so all boot environments inherit it - zfs set org.zfsbootmenu:commandline="$cmdline" "$POOL_NAME/ROOT" - info "Kernel command line set on $POOL_NAME/ROOT (inherited by children)" - - # Set bootfs property - tells ZFSBootMenu which dataset to boot by default - zpool set bootfs="$POOL_NAME/ROOT/default" "$POOL_NAME" - info "Default boot filesystem set to $POOL_NAME/ROOT/default" - - # Create EFI boot entries for each disk - # ZFSBootMenu EFI parameters (passed via --unicode): - # spl_hostid=0x... - Required for pool import - # zbm.timeout=3 - Seconds before auto-boot (-1 = always show menu) - # zbm.prefer=POOLNAME - Preferred pool to boot from - # zbm.import_policy=hostid - How to handle pool imports - local zbm_cmdline="spl_hostid=0x${host_id} zbm.timeout=3 zbm.prefer=${POOL_NAME} zbm.import_policy=hostid" - - for i in "${!SELECTED_DISKS[@]}"; do - local disk="${SELECTED_DISKS[$i]}" - local label="ZFSBootMenu" - if [[ ${#SELECTED_DISKS[@]} -gt 1 ]]; then - label="ZFSBootMenu-disk$((i+1))" - fi - - # Determine partition number (always 1 - first partition is EFI) - local part_num=1 - - info "Creating EFI boot entry: $label on $disk" - efibootmgr --create \ - --disk "$disk" \ - --part "$part_num" \ - --label "$label" \ - --loader '\EFI\ZBM\zfsbootmenu.efi' \ - --unicode "$zbm_cmdline" \ - --quiet - done - - # Get the boot entry number and set as first in boot order - local bootnum=$(efibootmgr | grep "ZFSBootMenu" | head -1 | grep -oP 'Boot\K[0-9A-F]+') - if [[ -n "$bootnum" ]]; then - # Get current boot order, prepend our entry - local current_order=$(efibootmgr | grep "BootOrder" | cut -d: -f2 | tr -d ' ') - efibootmgr --bootorder "$bootnum,$current_order" --quiet - info "ZFSBootMenu set as primary boot option" - fi - - info "ZFSBootMenu configuration complete." -} -#+end_src - -** Step 8: Delete configure_grub_zfs_snap() - -Location: custom/install-archzfs, lines 1166-1184 - -Delete the entire function - ZFSBootMenu handles snapshot menus natively. - -** Step 9: Update sync_efi_partitions() - -Location: custom/install-archzfs, lines 1285-1315 - -Changes: -- Sync ZFSBootMenu binary instead of GRUB -- Create EFI boot entries for secondary disks - -#+begin_src bash -sync_efi_partitions() { - [[ ${#EFI_PARTS[@]} -le 1 ]] && return - - step "Syncing EFI Partitions for Redundancy" - - for i in "${!EFI_PARTS[@]}"; do - [[ $i -eq 0 ]] && continue - - local efi_part="${EFI_PARTS[$i]}" - local temp_mount="/mnt/efi_sync" - - info "Syncing ZFSBootMenu to EFI partition $((i+1)): $efi_part" - - mkdir -p "$temp_mount" - mount "$efi_part" "$temp_mount" - - # Copy ZFSBootMenu binary - mkdir -p "$temp_mount/EFI/ZBM" - cp /mnt/efi/EFI/ZBM/zfsbootmenu.efi "$temp_mount/EFI/ZBM/" - - umount "$temp_mount" - done - - rmdir "$temp_mount" 2>/dev/null || true - info "All EFI partitions synchronized." -} -#+end_src - -** Step 10: Update cleanup() - -Location: custom/install-archzfs, lines 1379-1393 - -Changes: -- Unmount /mnt/efi instead of /mnt/boot - -#+begin_src bash -# Change: -umount /mnt/boot 2>/dev/null || true - -# To: -umount /mnt/efi 2>/dev/null || true -#+end_src - -** Step 11: Update print_summary() - -Location: custom/install-archzfs, lines 1395-1424 - -Changes: -- Update bootloader references from GRUB to ZFSBootMenu -- Update useful commands section - -#+begin_src bash -# Update the "ZFS Features" section: -echo "ZFS Features:" -echo " - ZFSBootMenu: boot from any snapshot" -echo " - Genesis snapshot: pristine post-install state" -echo " - Pre-pacman snapshots for safe upgrades" -echo "" -echo "Boot Menu Keys (at ZFSBootMenu):" -echo " Enter - Boot selected environment" -echo " e - Edit kernel command line" -echo " Ctrl+D - Show snapshot selector" -echo " Ctrl+R - Recovery shell" -#+end_src - -** Step 12: Update build.sh - -Location: build.sh - -Changes: -- Remove grub-zfs-snap file copies (lines ~375-380) -- Remove grub-zfs-snap permissions (line ~408) -- Keep bootloader configs for live ISO (still uses GRUB/syslinux) - -#+begin_src bash -# DELETE these lines from build.sh: - -# Copy grub-zfs-snap to ISO -cp custom/grub-zfs-snap profile/airootfs/usr/local/bin/grub-zfs-snap -mkdir -p profile/airootfs/usr/local/share/grub-zfs-snap -cp custom/40_zfs_snapshots profile/airootfs/usr/local/share/grub-zfs-snap/ -cp custom/zz-grub-zfs-snap.hook profile/airootfs/usr/local/share/grub-zfs-snap/ - -# And from file_permissions: -["usr/local/bin/grub-zfs-snap"]="0:0:755" -#+end_src - -** Step 13: Update zfssnapshot and zfsrollback - -Location: custom/zfssnapshot, custom/zfsrollback - -Changes: -- Remove calls to grub-zfs-snap -- ZFSBootMenu auto-detects snapshots, no regeneration needed - -#+begin_src bash -# DELETE from zfssnapshot (around line 107): -grub-zfs-snap 2>/dev/null || true - -# DELETE from zfsrollback (around line 177): -grub-zfs-snap 2>/dev/null || true -#+end_src - -** Step 14: Delete GRUB-specific files - -Files to delete from custom/: -- custom/grub-zfs-snap -- custom/40_zfs_snapshots -- custom/zz-grub-zfs-snap.hook - -#+begin_src bash -rm custom/grub-zfs-snap -rm custom/40_zfs_snapshots -rm custom/zz-grub-zfs-snap.hook -#+end_src - -** Step 15: Update main() function call order - -Location: custom/install-archzfs, main() around line 1443 - -Changes: -- Replace configure_bootloader with configure_zfsbootmenu -- Remove configure_grub_zfs_snap call - -#+begin_src bash -# Change this sequence: - configure_initramfs - configure_bootloader # <- rename - configure_grub_zfs_snap # <- delete - configure_zfs_services - -# To: - configure_initramfs - configure_zfsbootmenu # <- new function - configure_zfs_services -#+end_src - -* Testing Plan - -** Test Environment - -- QEMU VM with UEFI firmware (OVMF) -- Multiple test scenarios for different disk configurations -- Existing test script: scripts/test-vm.sh - -** Test 1: Single Disk Install - -#+begin_src bash -# Start VM -./scripts/test-vm.sh - -# In VM, run installer -install-archzfs - -# Select single disk -# Complete installation -# Reboot -#+end_src - -*Validation Points:* -- [ ] EFI partition is 512MB (not 1GB) -- [ ] /efi contains only EFI/ZBM/zfsbootmenu.efi -- [ ] /boot is a directory (NOT a dataset): =zfs list= should NOT show zroot/ROOT/default/boot -- [ ] Kernel files exist in /boot/ (=ls /boot/vmlinuz*=) -- [ ] ZFSBootMenu menu appears on boot -- [ ] Can boot into installed system -- [ ] After login: =zfs get org.zfsbootmenu:commandline zroot/ROOT= shows cmdline (set on parent) -- [ ] After login: =zpool get bootfs zroot= shows zroot/ROOT/default - -** Test 2: Mirror Install (2 disks) - -#+begin_src bash -# Create second virtual disk -qemu-img create -f qcow2 test-disk2.qcow2 50G - -# Modify test-vm.sh to add second disk -# -drive file=test-disk2.qcow2,if=virtio - -# Run installer, select both disks, choose mirror -#+end_src - -*Validation Points:* -- [ ] Both disks have EFI partitions -- [ ] ZFSBootMenu binary exists on both EFI partitions -- [ ] EFI boot entries exist for both disks (efibootmgr -v) -- [ ] Can boot from either disk (test by removing first disk) -- [ ] ZFS pool shows mirror topology (zpool status) - -** Test 3: RAIDZ1 Install (3 disks) - -*Validation Points:* -- [ ] All three disks have EFI partitions with ZFSBootMenu -- [ ] Three EFI boot entries created -- [ ] ZFS pool shows raidz1 topology - -** Test 4: Snapshot Boot - -#+begin_src bash -# After installation and first boot: - -# Create a test file -echo "original" > /root/test.txt - -# Create a snapshot -zfs snapshot zroot/ROOT/default@test-snap - -# Modify the file -echo "modified" > /root/test.txt - -# Reboot, at ZFSBootMenu press Ctrl+D -# Select zroot/ROOT/default@test-snap -# Boot from snapshot -#+end_src - -*Validation Points:* -- [ ] ZFSBootMenu shows snapshot selector with Ctrl+D -- [ ] Snapshot appears in list -- [ ] Booting from snapshot shows original file content -- [ ] Kernel version matches (no mismatch errors) - -** Test 5: Kernel Update Scenario - -#+begin_src bash -# Simulate kernel update (or actually do one) -pacman -Syu - -# Reboot -#+end_src - -*Validation Points:* -- [ ] New kernel is on ZFS (included in future snapshots) -- [ ] ZFSBootMenu detects and boots new kernel -- [ ] No manual regeneration needed (unlike GRUB) - -** Test 6: Recovery Shell - -#+begin_src bash -# At ZFSBootMenu, press Ctrl+R -#+end_src - -*Validation Points:* -- [ ] Recovery shell accessible -- [ ] ZFS pool is importable from recovery -- [ ] Can manually mount and chroot if needed - -** Test 7: Encrypted Pool - -#+begin_src bash -# Run installer with encryption enabled -# Enter passphrase when prompted -#+end_src - -*Validation Points:* -- [ ] ZFSBootMenu prompts for passphrase -- [ ] Pool unlocks successfully -- [ ] System boots normally after passphrase entry - -* Validation Checklist (All Tests) - -** Pre-Installation -- [ ] Live ISO boots successfully -- [ ] ZFS module loads (lsmod | grep zfs) - -** Partitioning -- [ ] EFI partition is 512MB -- [ ] ZFS partition uses remaining space -- [ ] Partition table is GPT - -** Filesystem Layout -- [ ] /efi is vfat, mounted from EFI partition -- [ ] /boot is a directory inside ROOT/default (NOT a separate dataset) -- [ ] Verify: =zfs list= should NOT show a zroot/ROOT/default/boot dataset -- [ ] Kernel/initramfs exist in /boot/ (on the ZFS root filesystem) - -** ZFSBootMenu -- [ ] zfsbootmenu.efi exists at /efi/EFI/ZBM/ -- [ ] EFI boot entry points to ZFSBootMenu -- [ ] org.zfsbootmenu:commandline property set on root dataset -- [ ] hostid included in cmdline (spl.spl_hostid=0x...) - -** Boot Process -- [ ] ZFSBootMenu menu appears -- [ ] Countdown timer works -- [ ] Default boot entry is correct -- [ ] Boot completes successfully -- [ ] All ZFS datasets mount correctly - -** Multi-Disk (if applicable) -- [ ] All EFI partitions contain zfsbootmenu.efi -- [ ] All disks have EFI boot entries -- [ ] Can boot from any disk - -** Snapshots -- [ ] Genesis snapshot created -- [ ] Ctrl+D shows snapshot selector -- [ ] Can boot from snapshot -- [ ] Snapshot includes matching kernel - -** Services -- [ ] zfs-import-scan.service enabled -- [ ] zfs-mount.service enabled -- [ ] NetworkManager starts -- [ ] SSH accessible (if enabled) - -* Rollback Plan - -If ZFSBootMenu implementation fails: - -1. Keep GRUB version in a git branch before changes -2. ISO still boots with GRUB (live environment unchanged) -3. Can install GRUB manually from live environment: - #+begin_src bash - pacstrap /mnt grub - arch-chroot /mnt grub-install --target=x86_64-efi --efi-directory=/boot - arch-chroot /mnt grub-mkconfig -o /boot/grub/grub.cfg - #+end_src - -* Research Findings (from comparable projects) - -This plan incorporates best practices from these open-source Arch+ZFS installers: - -** eoli3n/archiso-zfs + arch-config -- ZFSBootMenu built from source with =generate-zbm= (we use pre-built binary for simplicity) -- Uses file-based encryption key (=/etc/zfs/zroot.key=) embedded in initramfs to avoid double passphrase prompt -- Sets =org.zfsbootmenu:commandline= on ROOT parent for inheritance to all boot environments -- Minimal dataset layout: ROOT, data/home - -** PandaScience/arch-on-zfs -- Uses rEFInd (not ZFSBootMenu), but documents the "smart dataset layout": - - =system/= for root, =userdata/= for home, =nobackup/= for cache/tmp -- Emphasizes =canmount=noauto= on root dataset (we already do this) -- Recommends =/boot= as directory inside root, NOT separate dataset - -** sandreas/zarch -- Downloads ZFSBootMenu binary from =https://get.zfsbootmenu.org/latest.EFI= (adopted) -- Uses efibootmgr =--unicode= parameter for ZFSBootMenu cmdline (adopted) -- ZFSBootMenu parameters: =spl_hostid=, =zbm.timeout=, =zbm.prefer=, =zbm.import_policy= (adopted) -- Uses zrepl for time-based snapshots (we use pacman hooks - complementary approach) - -** danboid/ALEZ -- Two-pool design (bpool + rpool) for GRUB compatibility - NOT needed with ZFSBootMenu -- systemd-boot ZFS entry uses =zfs=POOL/ROOT/default= parameter -- Pool export/reimport pattern for clean state - -** danfossi/Arch-ZFS-Root-Installation-Script -- Uses =compatibility=grub2= pool option for GRUB - NOT needed with ZFSBootMenu -- Good partition suffix helper for nvme/mmcblk naming (we already have this) -- Separate bpool for boot - NOT needed with ZFSBootMenu - -** Key Lessons Adopted - -1. *DO NOT create separate /boot dataset* - must be directory inside root -2. *Set commandline on ROOT parent* - inherited by all boot environments -3. *Use =--unicode= for ZFSBootMenu parameters* - spl_hostid, zbm.timeout, zbm.prefer -4. *Download pre-built EFI binary* - simpler than building from AUR -5. *Copy hostid to installed system* - required for pool import -6. *Set bootfs pool property* - tells ZFSBootMenu default boot target - -** Optional Enhancement: File-Based Encryption Key - -From eoli3n: To avoid entering passphrase twice (ZFSBootMenu + initramfs): - -#+begin_src bash -# During pool creation, use keylocation=file instead of prompt -echo "$ZFS_PASSPHRASE" > /mnt/etc/zfs/zroot.key -chmod 000 /mnt/etc/zfs/zroot.key - -# Add to mkinitcpio FILES -echo 'FILES+=(/etc/zfs/zroot.key)' >> /mnt/etc/mkinitcpio.conf.d/zfs-key.conf - -# Change keylocation -zfs set keylocation=file:///etc/zfs/zroot.key zroot -#+end_src - -Trade-off: Simpler UX (one passphrase) but key is in initramfs on ZFS. -*Current plan uses prompt-based* - user enters passphrase at ZFSBootMenu. - -* References - -** Official Documentation -- ZFSBootMenu Documentation: https://docs.zfsbootmenu.org/ -- ZFSBootMenu GitHub: https://github.com/zbm-dev/zfsbootmenu -- ZFSBootMenu man page: https://docs.zfsbootmenu.org/en/latest/man/zfsbootmenu.7.html -- Arch Wiki ZFS: https://wiki.archlinux.org/title/ZFS - -** Researched Projects -- eoli3n/archiso-zfs: https://github.com/eoli3n/archiso-zfs -- eoli3n/arch-config: https://github.com/eoli3n/arch-config -- PandaScience/arch-on-zfs: https://github.com/PandaScience/arch-on-zfs -- sandreas/zarch: https://github.com/sandreas/zarch -- danboid/ALEZ: https://github.com/danboid/ALEZ -- danfossi/Arch-ZFS-Root-Installation-Script: https://github.com/danfossi/Arch-ZFS-Root-Installation-Script - -** Guides -- Florian Esser's ZFSBootMenu Guide: https://florianesser.ch/posts/20220714-arch-install-zbm/ -- Arch Wiki ZFSBootMenu: https://wiki.archlinux.org/title/User:Kayvlim/Install_UEFI_and_BIOS_compatible_Arch_Linux_with_Encrypted_ZFS_and_ZFSBootMenu - -* Implementation Order - -1. Create git branch: =git checkout -b zfsbootmenu= -2. Delete GRUB files (Step 14) -3. Update build.sh (Step 12) -4. Update install-archzfs (Steps 1-11, 15) -5. Update helper scripts (Step 13) -6. Build new ISO -7. Run Test 1 (single disk) -8. Fix any issues -9. Run Tests 2-7 -10. Merge to main when all tests pass |