1GRUB-INSTALL(8)         System Administration Utilities        GRUB-INSTALL(8)
2
3
4

NAME

6       grub-install - install GRUB to a device
7

SYNOPSIS

9       grub-install [OPTION...] [OPTION] [INSTALL_DEVICE]
10

DESCRIPTION

12       Install GRUB on your drive.
13
14       --appended-signature-size=SIZE
15              Add  a  note segment reserving SIZE bytes for an appended signa‐
16              ture
17
18       --compress=no|xz|gz|lzo
19              compress GRUB files [optional]
20
21       --disable-shim-lock
22              disable shim_lock verifier
23
24       --dtb=FILE
25              embed a specific DTB
26
27       -d, --directory=DIR
28              use images and modules under  DIR  [default=/usr/lib/grub/<plat‐
29              form>]
30
31       --fonts=FONTS
32              install FONTS [default=unicode]
33
34       --install-modules=MODULES
35              install only MODULES and their dependencies [default=all]
36
37       -k, --pubkey=FILE
38              embed FILE as public key for signature checking
39
40       --locale-directory=DIR use translations under DIR
41              [default=/usr/share/locale]
42
43       --locales=LOCALES
44              install only LOCALES [default=all]
45
46       --modules=MODULES
47              pre-load specified modules MODULES
48
49       --sbat=FILE
50              SBAT metadata
51
52       --themes=THEMES
53              install THEMES [default=starfield]
54
55       -v, --verbose
56              print verbose messages.
57
58       -x, --x509key=FILE
59              embed FILE as an x509 certificate for signature checking
60
61       --allow-floppy
62              make  the  drive  also  bootable  as floppy (default for fdX de‐
63              vices). May break on some BIOSes.
64
65       --boot-directory=DIR
66              install GRUB images under the directory DIR/grub2 instead of the
67              boot/grub2 directory
68
69       --bootloader-id=ID
70              the  ID  of bootloader. This option is only available on EFI and
71              Macs.
72
73       --core-compress=xz|none|auto
74              choose the compression to use for core image
75
76       --disk-module=MODULE
77              disk module to use (biosdisk or native).  This  option  is  only
78              available on BIOS target.
79
80       --efi-directory=DIR
81              use DIR as the EFI System Partition root.
82
83       --force
84              install even if problems are detected
85
86       --force-file-id
87              use identifier file even if UUID is available
88
89       --label-bgcolor=COLOR
90              use COLOR for label background
91
92       --label-color=COLOR
93              use COLOR for label
94
95       --label-font=FILE
96              use FILE as font for label
97
98       --macppc-directory=DIR use DIR for PPC MAC install.
99
100       --no-bootsector
101              do not install bootsector
102
103       --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
107       --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
111       --product-version=STRING
112              use STRING as product version
113
114       --recheck
115              delete device map if it already exists
116
117       --removable
118              the installation device is removable. This option is only avail‐
119              able on EFI.
120
121       -s, --skip-fs-probe
122              do not probe for filesystems in DEVICE
123
124       --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
133       -?, --help
134              give this help list
135
136       --usage
137              give a short usage message
138
139       -V, --version
140              print program version
141
142       Mandatory or optional arguments to long options are also  mandatory  or
143       optional for any corresponding short options.
144
145       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

REPORTING BUGS

150       Report bugs to <bug-grub@gnu.org>.
151

SEE ALSO

153       grub-mkconfig(8), grub-mkimage(1), grub-mkrescue(1)
154
155       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
159              info grub-install
160
161       should give you access to the complete manual.
162
163
164
165GRUB 2.06                        January 2023                  GRUB-INSTALL(8)
Impressum