1GRUB-INSTALL(1) General Commands Manual GRUB-INSTALL(1)
2
6 grub-install — Install GRUB on a device.
7
10 grub-install [--modules=MODULES] [--install-modules=MODULES]
11 [--themes=THEMES] [--fonts=FONTS] [--locales=LOCALES]
12 [--compress[=no,xz,gz,lzo]] [-d | --directory=DIR]
13 [--grub-mkimage=FILE] [--boot-directory=DIR]
14 [--target=TARGET] [--grub-setup=FILE]
15 [--grub-mkrelpath=FILE] [--grub-probe=FILE]
16 [--allow-floppy] [--recheck] [--force] [--force-file-id]
17 [--disk-module=MODULE] [--no-nvram] [--removable]
18 [--bootloader-id=ID] [--efi-directory=DIR] INSTALL_DEVICE
19
22 grub-install installs GRUB onto a device. This includes copying GRUB
23 images into the target directory (generally /boot/grub), and on some
24 platforms may also include installing GRUB onto a boot sector.
25 In order to support UEFI Secure Boot, the resulting GRUB EFI binary
27 must be signed by a recognized private key. For this reason, for EFI
28 platforms, most distributions also ship prebuilt GRUB EFI binaries
29 signed by a distribution-specific private key. In this case, however,
30 the grub-install utility should not be used because it would overwrite
31 the signed EFI binary.
32
35 --modules=MODULES
36 Pre-load modules specified by MODULES.
37 --install-modules=MODULES
40 Install only MODULES and their dependencies. The default is to
41 install all available modules.
42 --themes=THEMES
45 Install THEMES. The default is to install the starfield theme,
46 if available.
47 --fonts=FONTS
50 Install FONTS. The default is to install the unicode font.
51 --locales=LOCALES
54 Install only locales listed in LOCALES. The default is to
55 install all available locales.
56 --compress=no,xz,gz,lzo
59 Compress GRUB files using the specified compression algorithm.
60 --directory=DIR
63 Use images and modules in DIR.
64 --grub-mkimage=FILE
67 Use FILE as grub-mkimage. The default is /usr/bin/grub-mkimage.
68 --boot-directory=DIR
71 Use DIR as the boot directory. The default is /boot. GRUB will
72 put its files in a subdirectory of this directory named grub.
73 --target=TARGET
76 Install GRUB for TARGET platform. The default is the platform
77 grub-install is running on.
78 --grub-setup=FILE
81 Use FILE as grub-setup. The default is /usr/bin/grub-setup.
82 --grub-mkrelpath=FILE
85 Use FILE as grub-mkrelpath. The default is /usr/bin/grub-mkrel‐
86 path.
87 --grub-probe=FILE
90 Use FILE as grub-probe. The default is /usr/bin/grub-mkrelpath.
91 --allow-floppy
94 Make the device also bootable as a floppy. This option is the
95 default for /dev/fdX devices. Some BIOSes will not boot images
96 created with this option.
97 --recheck
100 Delete any existing device map and create a new one if neces‐
101 sary.
102 --force
105 Install even if problems are detected.
106 --force-file-id
109 Use identifier file even if UUID is available.
110 --disk-module=MODULE
113 Use MODULE for disk access. This allows you to manually specify
114 either biosdisk or native disk access. This option is only
115 available on the BIOS target platform.
116 --no-nvram
119 Do not update the boot-device NVRAM variable. This option is
120 only available on IEEE1275 target platforms.
121 --removable
124 Treat the target device as if it is removeable. This option is
125 only available on the EFI target platform.
126 --bootloader-id=ID
129 Use ID as the bootloader ID. This option is only available on
130 the EFI target platform.
131 --efi-directory=DIR
134 Use DIR as the EFI System Partition root. This option is only
135 available on the EFI target platform.
136 INSTALL_DEVICE
139 Install GRUB to the block device INSTALL_DEVICE.
140
143 info grub
144 Fri Nov 20 2020 GRUB-INSTALL(1)