GRUB-INSTALL(8) System Administration Utilities GRUB-INSTALL(8)

grub-install - install GRUB to a device

grub-install [OPTION...] [OPTION] [INSTALL_DEVICE]

Install GRUB on your drive.

compress GRUB files [optional]
disable shim_lock verifier
embed a specific DTB
use images and modules under DIR [default=/usr/lib/grub/<platform>]
install FONTS [default=unicode]
install only MODULES and their dependencies [default=all]
embed FILE as public key for signature checking
install only LOCALES [default=all]
pre-load specified modules MODULES
SBAT metadata
install THEMES [default=starfield]
print verbose messages.
make the drive also bootable as floppy (default for fdX devices). May break on some BIOSes.
install GRUB images under the directory DIR/grub instead of the /boot/grub directory
the ID of bootloader. This option is only available on EFI and Macs.
choose the compression to use for core image
disk module to use (biosdisk or native). This option is only available on BIOS target.
use DIR as the EFI System Partition root.
install even if problems are detected
use identifier file even if UUID is available
use COLOR for label background
use COLOR for label
use FILE as font for label

--macppc-directory=DIR use DIR for PPC MAC install.

do not install bootsector
don't update the `boot-device'/`Boot*' NVRAM variables. This option is only available on EFI and IEEE1275 targets.
Do not apply any reed-solomon codes when embedding core.img. This option is only available on x86 BIOS targets.
use STRING as product version
delete device map if it already exists
the installation device is removable. This option is only available on EFI.
do not probe for filesystems in DEVICE
install GRUB for TARGET platform [default=x86_64-efi]; available targets: arm-coreboot, arm-efi, arm-uboot, arm64-efi, i386-coreboot, i386-efi, i386-ieee1275, i386-multiboot, i386-pc, i386-qemu, i386-xen, i386-xen_pvh, ia64-efi, loongarch64-efi, mips-arc, mips-qemu_mips, mipsel-arc, mipsel-loongson, mipsel-qemu_mips, powerpc-ieee1275, riscv32-efi, riscv64-efi, sparc64-ieee1275, x86_64-efi, x86_64-xen
-?, --help
give this help list
give a short usage message
print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

INSTALL_DEVICE must be system device filename. grub-install copies GRUB images into /boot/grub. On some platforms, it may also install GRUB into the boot sector.

Report bugs to <>.

grub-mkconfig(8), grub-mkimage(1), grub-mkrescue(1)

The full documentation for grub-install is maintained as a Texinfo manual. If the info and grub-install programs are properly installed at your site, the command

info grub-install

should give you access to the complete manual.

March 2024 GRUB 2:2.12-2