grub2-install - Man Page

install GRUB to a device


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


Install GRUB on your drive.


Add a note segment reserving SIZE bytes for an appended signature


compress GRUB files [optional]


disable shim_lock verifier


embed a specific DTB

-d,  --directory=DIR

use images and modules under DIR [default=/usr/lib/grub/<platform>]


install FONTS [default=unicode]


install only MODULES and their dependencies [default=all]

-k,  --pubkey=FILE

embed FILE as public key for signature checking

--locale-directory=DIR use translations under DIR



install only LOCALES [default=all]


pre-load specified modules MODULES


SBAT metadata


install THEMES [default=starfield]

-v,  --verbose

print verbose messages.

-x,  --x509key=FILE

embed FILE as an x509 certificate for signature checking


make the drive also bootable as floppy (default for fdX devices). May break on some BIOSes.


install GRUB images under the directory DIR/grub2 instead of the boot/grub2 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.

-s,  --skip-fs-probe

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, 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

-V,  --version

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/grub2.  On some platforms, it may also install GRUB into the boot sector.

Reporting Bugs

Report bugs to <>.

See Also

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.


February 2024 GRUB 2.06 System Administration Utilities