grub2-install man page

grub-install — Install GRUB on a device.

Synopsis

grub-install [--modules=MODULES] [--install-modules=MODULES]

[--themes=THEMES] [--fonts=FONTS] [--locales=LOCALES]

[--compress[=no,xz,gz,lzo]] [-d | --directory=DIR]

[--target=TARGET] [--grub-setup=FILE]

[--bootloader-id=ID] [--efi-directory=DIR] INSTALL_DEVICE

Description

grub-install installs GRUB onto a device. This includes copying GRUB images into the target directory (generally /boot/grub), and on some platforms may also include installing GRUB onto a boot sector.

Options

--modules=MODULES!
Pre-load modules specified by MODULES.
--install-modules=MODULES
Install only MODULES and their dependencies. The default is to install all available modules.
--themes=THEMES
Install THEMES. The default is to install the starfield theme, if available.
--fonts=FONTS
Install FONTS. The default is to install the unicode font.
--locales=LOCALES
Install only locales listed in LOCALES. The default is to install all available locales.
--compress=no,xz,gz,lzo
Compress GRUB files using the specified compression algorithm.
--directory=DIR
Use images and modules in DIR.
--grub-mkimage=FILE
Use FILE as grub-mkimage. The default is /usr/bin/grub-mkimage.
--boot-directory=DIR
Use DIR as the boot directory. The default is /boot. GRUB will put its files in a subdirectory of this directory named grub.
--target=TARGET
Install GRUB for TARGET platform. The default is the platform grub-install is running on.
--grub-setup=FILE
Use FILE as grub-setup. The default is /usr/bin/grub-setup.
--grub-mkrelpath=FILE
Use FILE as grub-mkrelpath. The default is /usr/bin/grub-mkrelpath.
--grub-probe=FILE
Use FILE as grub-probe. The default is /usr/bin/grub-mkrelpath.
--allow-floppy
Make the device also bootable as a floppy. This option is the default for /dev/fdX devices. Some BIOSes will not boot images created with this option.
--recheck
Delete any existing device map and create a new one if necessary.
--force
Install even if problems are detected.
--force-file-id
Use identifier file even if UUID is available.
--disk-module=MODULE
Use MODULE for disk access. This allows you to manually specify either biosdisk or native disk access. This option is only available on the BIOS target platform.
--no-nvram
Do not update the boot-device NVRAM variable. This option is only available on IEEE1275 target platforms.
--removable
Treat the target device as if it is removeable. This option is only available on the EFI target platform.
--bootloader-id=ID
Use ID as the bootloader ID. This opption is only available on the EFI target platform.
--efi-directory=DIR
Use DIR as the EFI System Partition root. This opption is only available on the EFI ta rget platform.
INSTALL_DEVICE
Install GRUB to the block device INSTALL_DEVICE.

See Also

info grub

Info

Wed Feb 26 2014