GRUB-INSTALL(8)            (July 2021)            GRUB-INSTALL(8)

     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]

          --dtb=,FILE/
               embed a specific DTB

          -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

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

     Page 1                    GRUB 2.04-20          (printed 5/23/22)

     GRUB-INSTALL(8)            (July 2021)            GRUB-INSTALL(8)

          --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 tar-
               gets.

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

     Page 2                    GRUB 2.04-20          (printed 5/23/22)

     GRUB-INSTALL(8)            (July 2021)            GRUB-INSTALL(8)

          --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 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@gnu.org>.

     Page 3                    GRUB 2.04-20          (printed 5/23/22)

     GRUB-INSTALL(8)            (July 2021)            GRUB-INSTALL(8)

     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.

     Page 4                    GRUB 2.04-20          (printed 5/23/22)