Skip to content

Commit 1634dec

Browse files
committed
chroot: add info for fallback UEFI location.
Thanks kwshi for suggesting grouping it together with removable media installation. More information can be found in [1]. [1] https://wiki.archlinux.org/title/GRUB#Default/fallback_boot_path
1 parent 541a3cf commit 1634dec

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

src/installation/guides/chroot.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -280,12 +280,29 @@ computer's firmware when manually selecting a boot device):
280280
(chroot) # grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="Void"
281281
```
282282

283-
If installing onto a removable disk (such as USB), add the option `--removable`
284-
to the `grub-install` command.
283+
### Troubleshooting GRUB installation
285284

286285
If EFI variables are not available, add the option `--no-nvram` to the
287286
`grub-install` command.
288287

288+
#### Installing on removable media or non-compliant UEFI systems
289+
290+
Unfortunately, not all systems have a fully standards compliant UEFI
291+
implementation. In some cases, it is necessary to "trick" the firmware into
292+
booting by using the default fallback location for the bootloader instead of a
293+
custom one. In that case, or if installing onto a removable disk (such as USB),
294+
add the option `--removable` to the `grub-install` command.
295+
296+
Alternatively, use [mkdir(1)](https://man.voidlinux.org/mkdir.1) to create the
297+
`/boot/efi/EFI/boot` directory and copy the installed GRUB executable, usually
298+
located in `/boot/efi/void/grubx64.efi` (its location can be found using
299+
[efibootmgr(8)](https://man.voidlinux.org/efibootmgr.8)), into the new folder:
300+
301+
```
302+
(chroot) # mkdir -p /boot/efi/boot
303+
(chroot) # cp /boot/efi/void/grubx64.efi /boot/efi/EFI/boot/bootx64.efi
304+
```
305+
289306
## Finalization
290307

291308
Use [xbps-reconfigure(1)](https://man.voidlinux.org/xbps-reconfigure.1) to

0 commit comments

Comments
 (0)