Debian Codegraph @

upstream/mageia-cauldron/man8/grub2-install.8

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH GRUB-INSTALL "8" "April 2026" "GRUB 2.12" "System Administration Utilities"
3 .SH NAME
4 grub-install \- install GRUB to a device
5 .SH SYNOPSIS
6 .B grub-install
7 [\fI\,OPTION\/\fR...] [\fI\,OPTION\/\fR] [\fI\,INSTALL_DEVICE\/\fR]
8 .SH DESCRIPTION
9 Install GRUB on your drive.
10 .TP
11 \fB\-\-appended\-signature\-size\fR=\fI\,SIZE\/\fR
12 Add a note segment reserving SIZE bytes for an
13 appended signature
14 .TP
15 \fB\-\-compress\fR=\fI\,no\/\fR|xz|gz|lzo
16 compress GRUB files [optional]
17 .TP
18 \fB\-\-disable\-cli\fR
19 disabled command line interface access
20 .TP
21 \fB\-\-disable\-shim\-lock\fR
22 disable shim_lock verifier
23 .TP
24 \fB\-\-dtb\fR=\fI\,FILE\/\fR
25 embed a specific DTB
26 .TP
27 \fB\-d\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
28 use images and modules under DIR
29 [default=/usr/lib/grub/<platform>]
30 .TP
31 \fB\-\-fonts\fR=\fI\,FONTS\/\fR
32 install FONTS [default=unicode]
33 .TP
34 \fB\-\-install\-modules\fR=\fI\,MODULES\/\fR
35 install only MODULES and their dependencies
36 [default=all]
37 .TP
38 \fB\-k\fR, \fB\-\-pubkey\fR=\fI\,FILE\/\fR
39 embed FILE as public key for signature checking
40 .TP
41 \fB\-\-locale\-directory\fR=\fI\,DIR\/\fR use translations under DIR
42 [default=/usr/share/locale]
43 .TP
44 \fB\-\-locales\fR=\fI\,LOCALES\/\fR
45 install only LOCALES [default=all]
46 .TP
47 \fB\-\-modules\fR=\fI\,MODULES\/\fR
48 pre\-load specified modules MODULES
49 .TP
50 \fB\-\-sbat\fR=\fI\,FILE\/\fR
51 SBAT metadata
52 .TP
53 \fB\-\-themes\fR=\fI\,THEMES\/\fR
54 install THEMES [default=starfield]
55 .TP
56 \fB\-v\fR, \fB\-\-verbose\fR
57 print verbose messages.
58 .TP
59 \fB\-x\fR, \fB\-\-x509key\fR=\fI\,FILE\/\fR
60 embed FILE as an x509 certificate for signature
61 checking
62 .TP
63 \fB\-\-allow\-floppy\fR
64 make the drive also bootable as floppy (default
65 for fdX devices). May break on some BIOSes.
66 .TP
67 \fB\-\-boot\-directory\fR=\fI\,DIR\/\fR
68 install GRUB images under the directory DIR/grub2
69 instead of the boot/grub2 directory
70 .TP
71 \fB\-\-bootloader\-id\fR=\fI\,ID\/\fR
72 the ID of bootloader. This option is only
73 available on EFI and Macs.
74 .TP
75 \fB\-\-core\-compress\fR=\fI\,xz\/\fR|none|auto
76 choose the compression to use for core image
77 .TP
78 \fB\-\-disk\-module\fR=\fI\,MODULE\/\fR
79 disk module to use (biosdisk or native). This
80 option is only available on BIOS target.
81 .TP
82 \fB\-\-efi\-directory\fR=\fI\,DIR\/\fR
83 use DIR as the EFI System Partition root.
84 .TP
85 \fB\-\-force\fR
86 install even if problems are detected
87 .TP
88 \fB\-\-force\-file\-id\fR
89 use identifier file even if UUID is available
90 .TP
91 \fB\-\-label\-bgcolor\fR=\fI\,COLOR\/\fR
92 use COLOR for label background
93 .TP
94 \fB\-\-label\-color\fR=\fI\,COLOR\/\fR
95 use COLOR for label
96 .TP
97 \fB\-\-label\-font\fR=\fI\,FILE\/\fR
98 use FILE as font for label
99 .HP
100 \fB\-\-macppc\-directory\fR=\fI\,DIR\/\fR use DIR for PPC MAC install.
101 .TP
102 \fB\-\-no\-bootsector\fR
103 do not install bootsector
104 .TP
105 \fB\-\-no\-nvram\fR
106 don't update the `boot\-device'/`Boot*' NVRAM
107 variables. This option is only available on EFI
108 and IEEE1275 targets.
109 .TP
110 \fB\-\-no\-rs\-codes\fR
111 Do not apply any reed\-solomon codes when
112 embedding core.img. This option is only available
113 on x86 BIOS targets.
114 .TP
115 \fB\-\-product\-version\fR=\fI\,STRING\/\fR
116 use STRING as product version
117 .TP
118 \fB\-\-recheck\fR
119 delete device map if it already exists
120 .TP
121 \fB\-\-removable\fR
122 the installation device is removable. This option
123 is only available on EFI.
124 .TP
125 \fB\-s\fR, \fB\-\-skip\-fs\-probe\fR
126 do not probe for filesystems in DEVICE
127 .TP
128 \fB\-\-target\fR=\fI\,TARGET\/\fR
129 install GRUB for TARGET platform
130 [default=i386\-pc]; available targets:
131 arm\-coreboot, arm\-efi, arm\-uboot, arm64\-efi,
132 i386\-coreboot, i386\-efi, i386\-ieee1275,
133 i386\-multiboot, i386\-pc, i386\-qemu, i386\-xen,
134 i386\-xen_pvh, ia64\-efi, loongarch64\-efi,
135 mips\-arc, mips\-qemu_mips, mipsel\-arc,
136 mipsel\-loongson, mipsel\-qemu_mips,
137 powerpc\-ieee1275, riscv32\-efi, riscv64\-efi,
138 sparc64\-ieee1275, x86_64\-efi, x86_64\-xen
139 .TP
140 \-?, \fB\-\-help\fR
141 give this help list
142 .TP
143 \fB\-\-usage\fR
144 give a short usage message
145 .TP
146 \fB\-V\fR, \fB\-\-version\fR
147 print program version
148 .PP
149 Mandatory or optional arguments to long options are also mandatory or optional
150 for any corresponding short options.
151 .PP
152 INSTALL_DEVICE must be system device filename.
153 grub\-install copies GRUB images into boot/grub2. On some platforms, it may
154 also install GRUB into the boot sector.
155 .SH "REPORTING BUGS"
156 Report bugs to <bug\[email protected]>.
157 .SH "SEE ALSO"
158 .BR grub-mkconfig (8),
159 .BR grub-mkimage (1),
160 .BR grub-mkrescue (1)
161 .PP
162 The full documentation for
163 .B grub-install
164 is maintained as a Texinfo manual. If the
165 .B info
166 and
167 .B grub-install
168 programs are properly installed at your site, the command
169 .IP
170 .B info grub-install
171 .PP
172 should give you access to the complete manual.