1GRUB-INSTALL(8) System Administration Utilities GRUB-INSTALL(8)
2
6 grub-install - install GRUB to a device
7
9 grub-install [OPTION...] [OPTION] [INSTALL_DEVICE]
10
12 Install GRUB on your drive.
13 --appended-signature-size=SIZE
15 Add a note segment reserving SIZE bytes for an appended signa‐
16 ture
17 --compress=no|xz|gz|lzo
19 compress GRUB files [optional]
20 --disable-shim-lock
22 disable shim_lock verifier
23 --dtb=FILE
25 embed a specific DTB
26 -d, --directory=DIR
28 use images and modules under DIR [default=/usr/lib/grub/<plat‐
29 form>]
30 --fonts=FONTS
32 install FONTS [default=unicode]
33 --install-modules=MODULES
35 install only MODULES and their dependencies [default=all]
36 -k, --pubkey=FILE
38 embed FILE as public key for signature checking
39 --locale-directory=DIR use translations under DIR
41 [default=/usr/share/locale]
42 --locales=LOCALES
44 install only LOCALES [default=all]
45 --modules=MODULES
47 pre-load specified modules MODULES
48 --sbat=FILE
50 SBAT metadata
51 --themes=THEMES
53 install THEMES [default=starfield]
54 -v, --verbose
56 print verbose messages.
57 -x, --x509key=FILE
59 embed FILE as an x509 certificate for signature checking
60 --allow-floppy
62 make the drive also bootable as floppy (default for fdX de‐
63 vices). May break on some BIOSes.
64 --boot-directory=DIR
66 install GRUB images under the directory DIR/grub2 instead of the
67 boot/grub2 directory
68 --bootloader-id=ID
70 the ID of bootloader. This option is only available on EFI and
71 Macs.
72 --core-compress=xz|none|auto
74 choose the compression to use for core image
75 --disk-module=MODULE
77 disk module to use (biosdisk or native). This option is only
78 available on BIOS target.
79 --efi-directory=DIR
81 use DIR as the EFI System Partition root.
82 --force
84 install even if problems are detected
85 --force-file-id
87 use identifier file even if UUID is available
88 --label-bgcolor=COLOR
90 use COLOR for label background
91 --label-color=COLOR
93 use COLOR for label
94 --label-font=FILE
96 use FILE as font for label
97 --macppc-directory=DIR use DIR for PPC MAC install.
99 --no-bootsector
101 do not install bootsector
102 --no-nvram
104 don't update the `boot-device'/`Boot*' NVRAM variables. This op‐
105 tion is only available on EFI and IEEE1275 targets.
106 --no-rs-codes
108 Do not apply any reed-solomon codes when embedding core.img.
109 This option is only available on x86 BIOS targets.
110 --product-version=STRING
112 use STRING as product version
113 --recheck
115 delete device map if it already exists
116 --removable
118 the installation device is removable. This option is only avail‐
119 able on EFI.
120 -s, --skip-fs-probe
122 do not probe for filesystems in DEVICE
123 --target=TARGET
125 install GRUB for TARGET platform [default=x86_64-efi]; available
126 targets: arm-coreboot, arm-efi, arm-uboot, arm64-efi, i386-core‐
127 boot, i386-efi, i386-ieee1275, i386-multiboot, i386-pc,
128 i386-qemu, i386-xen, i386-xen_pvh, ia64-efi, mips-arc,
129 mips-qemu_mips, mipsel-arc, mipsel-loongson, mipsel-qemu_mips,
130 powerpc-ieee1275, riscv32-efi, riscv64-efi, sparc64-ieee1275,
131 x86_64-efi, x86_64-xen
132 -?, --help
134 give this help list
135 --usage
137 give a short usage message
138 -V, --version
140 print program version
141 Mandatory or optional arguments to long options are also mandatory or
143 optional for any corresponding short options.
144 INSTALL_DEVICE must be system device filename. grub-install copies
146 GRUB images into boot/grub2. On some platforms, it may also install
147 GRUB into the boot sector.
148
150 Report bugs to <bug-grub@gnu.org>.
151
153 grub-mkconfig(8), grub-mkimage(1), grub-mkrescue(1)
154 The full documentation for grub-install is maintained as a Texinfo man‐
156 ual. If the info and grub-install programs are properly installed at
157 your site, the command
158 info grub-install
160 should give you access to the complete manual.
162GRUB 2.06 December 2023 GRUB-INSTALL(8)