Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  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/local/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.
--force 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
--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.


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.

Search for    or go to Top of page |  Section 8 |  Main Index

grub-install (GRUB) 2.02~beta2 GRUB-INSTALL (8) April 2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.