.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH GRUB-INSTALL "8" "April 2024" "GRUB 2.12-2~deb13u1" "System Administration Utilities"
.SH NAME
grub-install \- install GRUB to a device
.SH SYNOPSIS
.B grub-install
[\fI\,OPTION\/\fR...] [\fI\,OPTION\/\fR] [\fI\,INSTALL_DEVICE\/\fR]
.SH DESCRIPTION
Install GRUB on your drive.
.TP
\fB\-\-compress\fR=\fI\,no\/\fR|xz|gz|lzo
compress GRUB files [optional]
.TP
\fB\-\-disable\-shim\-lock\fR
disable shim_lock verifier
.TP
\fB\-\-dtb\fR=\fI\,FILE\/\fR
embed a specific DTB
.TP
\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
use images and modules under DIR
[default=/usr/lib/grub/<platform>]
.TP
\fB\-\-fonts\fR=\fI\,FONTS\/\fR
install FONTS [default=unicode]
.TP
\fB\-\-install\-modules\fR=\fI\,MODULES\/\fR
install only MODULES and their dependencies
[default=all]
.TP
\fB\-k\fR, \fB\-\-pubkey\fR=\fI\,FILE\/\fR
embed FILE as public key for signature checking
.TP
\fB\-\-locale\-directory\fR=\fI\,DIR\/\fR use translations under DIR
[default=/usr/share/locale]
.TP
\fB\-\-locales\fR=\fI\,LOCALES\/\fR
install only LOCALES [default=all]
.TP
\fB\-\-modules\fR=\fI\,MODULES\/\fR
pre\-load specified modules MODULES
.TP
\fB\-\-sbat\fR=\fI\,FILE\/\fR
SBAT metadata
.TP
\fB\-\-themes\fR=\fI\,THEMES\/\fR
install THEMES [default=starfield]
.TP
\fB\-v\fR, \fB\-\-verbose\fR
print verbose messages.
.TP
\fB\-\-allow\-floppy\fR
make the drive also bootable as floppy (default
for fdX devices). May break on some BIOSes.
.TP
\fB\-\-boot\-directory\fR=\fI\,DIR\/\fR
install GRUB images under the directory DIR/grub
instead of the boot/grub directory
.TP
\fB\-\-bootloader\-id\fR=\fI\,ID\/\fR
the ID of bootloader. This option is only
available on EFI and Macs.
.TP
\fB\-\-core\-compress\fR=\fI\,xz\/\fR|none|auto
choose the compression to use for core image
.TP
\fB\-\-disk\-module\fR=\fI\,MODULE\/\fR
disk module to use (biosdisk or native). This
option is only available on BIOS target.
.TP
\fB\-\-efi\-directory\fR=\fI\,DIR\/\fR
use DIR as the EFI System Partition root.
.TP
\fB\-\-force\fR
install even if problems are detected
.TP
\fB\-\-force\-extra\-removable\fR
force installation to the removable media path
also. This option is only available on EFI.
.TP
\fB\-\-force\-file\-id\fR
use identifier file even if UUID is available
.TP
\fB\-\-label\-bgcolor\fR=\fI\,COLOR\/\fR
use COLOR for label background
.TP
\fB\-\-label\-color\fR=\fI\,COLOR\/\fR
use COLOR for label
.TP
\fB\-\-label\-font\fR=\fI\,FILE\/\fR
use FILE as font for label
.HP
\fB\-\-macppc\-directory\fR=\fI\,DIR\/\fR use DIR for PPC MAC install.
.TP
\fB\-\-no\-bootsector\fR
do not install bootsector
.TP
\fB\-\-no\-nvram\fR
don't update the `boot\-device'/`Boot*' NVRAM
variables. This option is only available on EFI
and IEEE1275 targets.
.TP
\fB\-\-no\-rs\-codes\fR
Do not apply any reed\-solomon codes when
embedding core.img. This option is only available
on x86 BIOS targets.
.TP
\fB\-\-no\-uefi\-secure\-boot\fR
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.
.TP
\fB\-\-product\-version\fR=\fI\,STRING\/\fR
use STRING as product version
.TP
\fB\-\-recheck\fR
delete device map if it already exists
.TP
\fB\-\-removable\fR
the installation device is removable. This option
is only available on EFI.
.TP
\fB\-s\fR, \fB\-\-skip\-fs\-probe\fR
do not probe for filesystems in DEVICE
.TP
\fB\-\-target\fR=\fI\,TARGET\/\fR
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, loongarch64\-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
.TP
\fB\-\-uefi\-secure\-boot\fR
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.
.TP
\-?, \fB\-\-help\fR
give this help list
.TP
\fB\-\-usage\fR
give a short usage message
.TP
\fB\-V\fR, \fB\-\-version\fR
print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP
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.
.SH "REPORTING BUGS"
Report bugs to <bug\-grub@gnu.org>.
.SH "SEE ALSO"
.BR grub-mkconfig (8),
.BR grub-mkimage (1),
.BR grub-mkrescue (1)
.PP
The full documentation for
.B grub-install
is maintained as a Texinfo manual.  If the
.B info
and
.B grub-install
programs are properly installed at your site, the command
.IP
.B info grub-install
.PP
should give you access to the complete manual.