From f293bc50a81565ad87cfcc4d910eda70885e5dea Mon Sep 17 00:00:00 2001 From: Alex Zenla Date: Sat, 26 Sep 2026 20:25:59 -0700 Subject: [PATCH] docs(setup): pass the disk and partition number to efibootmgr The unsigned setup guides passed the EFI System Partition device to efibootmgr -d, which expects the disk, and left out -p, which defaults to partition 1. The command failed, or created a boot entry for the wrong partition when the ESP isn't the first one. Pass the disk and the partition number, as the signed guides do. --- docs/setup/unsigned/alpine-edge.md | 6 ++++-- docs/setup/unsigned/fedora.md | 6 ++++-- docs/setup/unsigned/generic-linux.md | 6 ++++-- 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/setup/unsigned/alpine-edge.md b/docs/setup/unsigned/alpine-edge.md index a288d5d..a040e86 100644 --- a/docs/setup/unsigned/alpine-edge.md +++ b/docs/setup/unsigned/alpine-edge.md @@ -102,10 +102,12 @@ You will need to install the `efibootmgr` package: $ apk add efibootmgr ``` -Once `efibootmgr` is installed, find the partition device of your EFI System Partition and run the following: +Once `efibootmgr` is installed, find the disk and partition number of your EFI System Partition and run the following. +For example, if your EFI System Partition is `/dev/nvme0n1p1`, the disk is `/dev/nvme0n1` and the partition +number is `1`: ```bash -$ efibootmgr -d /dev/esp_partition_here -C -L 'Sprout' -l '\EFI\boot\sprout.efi' +$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -C -L 'Sprout' -l '\EFI\boot\sprout.efi' ``` This will add a new entry to your EFI boot menu called `Sprout` that will boot Sprout with your configuration. diff --git a/docs/setup/unsigned/fedora.md b/docs/setup/unsigned/fedora.md index d0a8b80..cf42e5d 100644 --- a/docs/setup/unsigned/fedora.md +++ b/docs/setup/unsigned/fedora.md @@ -107,10 +107,12 @@ You may now reboot your system and select Sprout from the GRUB menu. You can configure your EFI boot menu to show Sprout as an option. -To do so, please find the partition device of your EFI System Partition and run the following: +To do so, please find the disk and partition number of your EFI System Partition and run the following. +For example, if your EFI System Partition is `/dev/nvme0n1p1`, the disk is `/dev/nvme0n1` and the partition +number is `1`: ```bash -$ sudo efibootmgr -d /dev/esp_partition_here -C -L 'Sprout' -l '\EFI\BOOT\sprout.efi' +$ sudo efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -C -L 'Sprout' -l '\EFI\BOOT\sprout.efi' ``` This will add a new entry to your EFI boot menu called `Sprout` that will boot Sprout with your configuration. diff --git a/docs/setup/unsigned/generic-linux.md b/docs/setup/unsigned/generic-linux.md index 0420db7..88dd0a4 100644 --- a/docs/setup/unsigned/generic-linux.md +++ b/docs/setup/unsigned/generic-linux.md @@ -52,10 +52,12 @@ They will be concatenated by a space and passed to the kernel. Since Sprout is still experimental, the following commands will add a boot entry to your EFI firmware for sprout but intentionally do not set it as the default boot entry. -To add the entry, please find the partition device of your EFI System Partition and run the following: +To add the entry, please find the disk and partition number of your EFI System Partition and run the following. +For example, if your EFI System Partition is `/dev/nvme0n1p1`, the disk is `/dev/nvme0n1` and the partition +number is `1`: ```bash -$ sudo efibootmgr -d /dev/esp_partition_here -C -L 'Sprout' -l '\EFI\BOOT\sprout.efi' +$ sudo efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -C -L 'Sprout' -l '\EFI\BOOT\sprout.efi' ``` This will add a new entry to your EFI boot menu called `Sprout` that will boot Sprout with your configuration.