Manpages

NAME

grub-install − install GRUB to a device

SYNOPSIS

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

DESCRIPTION

Install GRUB on your drive.
−−compress
=no|xz|gz|lzo

compress GRUB files [optional]

−d, −−directory=DIR

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

−−fonts=FONTS

install FONTS [default=unicode]

−−install−modules=MODULES

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

[default=/usr/share/locale]

−−locales=LOCALES

install only LOCALES [default=all]

−−modules=MODULES

pre−load specified modules MODULES

−−themes=THEMES

install THEMES [default=starfield]

−v, −−verbose

print verbose messages.

−−allow−floppy

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

−−boot−directory=DIR

install GRUB images under the directory DIR/grub instead of the boot/grub directory

−−bootloader−id=ID

the ID of bootloader. This option is only available on EFI and Macs.

−−core−compress=xz|none|auto

choose the compression to use for core image

−−disk−module=MODULE

disk module to use (biosdisk or native). This option is only available on BIOS target.

−−efi−directory=DIR

use DIR as the EFI System Partition root.

−−force

install even if problems are detected

−−force−extra−removable

force installation to the removable media path also. This option is only available on EFI.

−−force−file−id

use identifier file even if UUID is available

−−label−bgcolor=COLOR

use COLOR for label background

−−label−color=COLOR

use COLOR for label

−−label−font=FILE

use FILE as font for label

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

−−no−bootsector

do not install bootsector

−−no−nvram

don’t update the ’boot−device’/’Boot*’ NVRAM variables. This option is only available on EFI and IEEE1275 targets.

−−no−rs−codes

Do not apply any reed−solomon codes when embedding core.img. This option is only available on x86 BIOS targets.

−−no−uefi−secure−boot

do not install an image usable with UEFI Secure Boot, even if the system was currently started using it. This option is only available on EFI.

−−product−version=STRING

use STRING as product version

−−recheck

delete device map if it already exists

−−removable

the installation device is removable. This option is only available on EFI.

−s, −−skip−fs−probe

do not probe for filesystems in DEVICE

Usage: grub−install [OPTION...] [OPTION] [INSTALL_DEVICE]

Install GRUB on your drive.
−−compress
=no|xz|gz|lzo

compress GRUB files [optional]

−d, −−directory=DIR

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

−−fonts=FONTS

install FONTS [default=unicode]

−−install−modules=MODULES

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

[default=/usr/share/locale]

−−locales=LOCALES

install only LOCALES [default=all]

−−modules=MODULES

pre−load specified modules MODULES

−−themes=THEMES

install THEMES [default=starfield]

−v, −−verbose

print verbose messages.

−−allow−floppy

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

−−boot−directory=DIR

install GRUB images under the directory DIR/grub instead of the boot/grub directory

−−bootloader−id=ID

the ID of bootloader. This option is only available on EFI and Macs.

−−core−compress=xz|none|auto

choose the compression to use for core image

−−disk−module=MODULE

disk module to use (biosdisk or native). This option is only available on BIOS target.

−−efi−directory=DIR

use DIR as the EFI System Partition root.

−−force

install even if problems are detected

−−force−extra−removable

force installation to the removable media path also. This option is only available on EFI.

−−force−file−id

use identifier file even if UUID is available

−−label−bgcolor=COLOR

use COLOR for label background

−−label−color=COLOR

use COLOR for label

−−label−font=FILE

use FILE as font for label

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

−−no−bootsector

do not install bootsector

−−no−nvram

don’t update the ’boot−device’/’Boot*’ NVRAM variables. This option is only available on EFI and IEEE1275 targets.

−−no−rs−codes

Do not apply any reed−solomon codes when embedding core.img. This option is only available on x86 BIOS targets.

−−no−uefi−secure−boot

do not install an image usable with UEFI Secure Boot, even if the system was currently started using it. This option is only available on EFI.

−−product−version=STRING

use STRING as product version

−−recheck

delete device map if it already exists

−−removable

the installation device is removable. This option is only available on EFI.

−s, −−skip−fs−probe

do not probe for filesystems in DEVICE

−−target=TARGET

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

−−uefi−secure−boot

install an image usable with UEFI Secure Boot. This option is only available on EFI and if the grub−efi−amd64−signed package is installed.

−?, −−help

give this help list

−−usage

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.

REPORTING BUGS

Report bugs to <bug−grub [AT] gnu.org>.

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.

COMMENTS