grub-install (8)

NAME

SYNOPSIS

DESCRIPTION

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

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

SEE ALSO

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.