# phpman > man > grub-install(8)

[GRUB-INSTALL(8)](https://www.chedong.com/phpMan.php/man/GRUB-INSTALL/8/markdown)                    System Administration Utilities                   [GRUB-INSTALL(8)](https://www.chedong.com/phpMan.php/man/GRUB-INSTALL/8/markdown)



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

### --disable-shim-lock
              disable shim_lock verifier

       **--dtb**=_FILE_
              embed a specific DTB

### -d --directory
              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
              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

       **--sbat**=_FILE_
              SBAT metadata

       **--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-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-extra-removable
              Do not install bootloader code to the removable media path. This option is only avail‐
              able on EFI.

### --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-coreboot,
              arm-efi, arm-uboot, arm64-efi, i386-coreboot, i386-efi, i386-ieee1275, i386-multiboot,
              i386-pc,  i386-qemu,  i386-xen,  i386-xen_pvh,  ia64-efi,  mips-arc,   mips-qemu_mips,
              mipsel-arc,    mipsel-loongson,   mipsel-qemu_mips,   powerpc-ieee1275,   riscv32-efi,
              riscv64-efi, 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 corre‐
       sponding 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@gnu.org>>.

## SEE ALSO
       [**grub-mkconfig**(8)](https://www.chedong.com/phpMan.php/man/grub-mkconfig/8/markdown), [**grub-mkimage**(1)](https://www.chedong.com/phpMan.php/man/grub-mkimage/1/markdown), [**grub-mkrescue**(1)](https://www.chedong.com/phpMan.php/man/grub-mkrescue/1/markdown)

       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.



GRUB 2.06-2ubuntu7.2                        December 2022                            [GRUB-INSTALL(8)](https://www.chedong.com/phpMan.php/man/GRUB-INSTALL/8/markdown)