Scroll to navigation

GRUB-INSTALL(1) General Commands Manual GRUB-INSTALL(1)

NAME

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]
[--grub-mkimage=FILE] [--boot-directory=DIR]
[--target=TARGET] [--grub-setup=FILE]
[--grub-mkrelpath=FILE] [--grub-probe=FILE]
[--allow-floppy] [--recheck] [--force] [--force-file-id]
[--disk-module=MODULE] [--no-nvram] [--removable]
[--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

Pre-load modules specified by MODULES.

Install only MODULES and their dependencies. The default is to install all available modules.

Install THEMES. The default is to install the starfield theme, if available.

Install FONTS. The default is to install the unicode font.

Install only locales listed in LOCALES. The default is to install all available locales.

Compress GRUB files using the specified compression algorithm.

Use images and modules in DIR.

Use FILE as grub-mkimage. The default is /usr/bin/grub-mkimage.

Use DIR as the boot directory. The default is /boot. GRUB will put its files in a subdirectory of this directory named grub.

Install GRUB for TARGET platform. The default is the platform grub-install is running on.

Use FILE as grub-setup. The default is /usr/bin/grub-setup.

Use FILE as grub-mkrelpath. The default is /usr/bin/grub-mkrelpath.

Use FILE as grub-probe. The default is /usr/bin/grub-mkrelpath.

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.

Delete any existing device map and create a new one if necessary.

Install even if problems are detected.

Use identifier file even if UUID is available.

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.

Do not update the boot-device NVRAM variable. This option is only available on IEEE1275 target platforms.

Treat the target device as if it is removeable. This option is only available on the EFI target platform.

Use ID as the bootloader ID. This opption is only available on the EFI target platform.

Use DIR as the EFI System Partition root. This opption is only available on the EFI ta rget platform.

Install GRUB to the block device INSTALL_DEVICE.

SEE ALSO

info grub

Wed Feb 26 2014