From e3bae1dc6342985d44930786a6cfd5129c2d564d Mon Sep 17 00:00:00 2001
From: Alex Zenla <alex@edera.dev>
Date: Mon, 20 Oct 2025 11:24:42 -0700
Subject: [PATCH] repair fedora setup guide to include copying grub modules

---
 docs/fedora-setup.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/fedora-setup.md b/docs/fedora-setup.md
index 0d0ba0d..32d0369 100644
--- a/docs/fedora-setup.md
+++ b/docs/fedora-setup.md
@@ -66,6 +66,26 @@ chainload.linux-initrd = "$boot\\$initrd"
 
 You can configure GRUB to add a boot entry for Sprout, so you can continue to use GRUB without interruption.
 
+GRUB needs to be configured with the chainloader module to load Sprout.
+
+### x86_64
+
+```bash
+# Install x86_64 GRUB modules.
+$ sudo dnf install grub2-efi-x64-modules
+# Copy x86_64 GRUB modules to /boot/grub2 for use by GRUB if it isn't installed already.
+$ [ ! -d /boot/grub2/x86_64-efi ] && sudo cp -r /usr/lib/grub/x86_64-efi /boot/grub2/x86_64-efi
+```
+
+### ARM64
+
+```bash
+# Install ARM64 GRUB modules.
+$ sudo dnf install grub2-efi-aa64-modules
+# Copy ARM64 GRUB modules to /boot/grub2 for use by GRUB if it isn't installed already.
+$ [ ! -d /boot/grub2/arm64-efi ] && sudo cp -r /usr/lib/grub/arm64-efi /boot/grub2/x86_64-efi
+```
+
 You will need to find the UUID of your EFI System Partition. You can do this by running the following command:
 ```bash
 $ grep "/boot/efi" /etc/fstab | awk '{print $1}' | awk -F '=' '{print $2}'
@@ -78,6 +98,7 @@ The GRUB configuration for Sprout is as follows, replace `SAMPLE-VALUE` with the
 menuentry 'Sprout' $menuentry_id_option 'sprout' {
         insmod part_gpt
         insmod fat
+        insmod chain
         search --no-floppy --fs-uuid --set=root SAMPLE-VALUE
         chainloader /EFI/BOOT/sprout.efi
 }