Arch manual pages

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]
-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
install THEMES [default=starfield]
-v, --verbose
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.
-s, --skip-fs-probe
do not probe for filesystems in DEVICE
install GRUB for TARGET platform [default=i386-pc]; available targets: arm-efi, arm-uboot, arm64-efi, i386-coreboot, i386-efi, i386-ieee1275, i386-multiboot, i386-pc, i386-qemu, i386-xen, ia64-efi, mips-arc, mips-qemu_mips, mipsel-arc, mipsel-loongson, mipsel-qemu_mips, powerpc-ieee1275, 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/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 2018 grub-install (GRUB) 2.02