1GRUB-INSTALL(1) General Commands Manual GRUB-INSTALL(1)
2
3
4
6 grub-install — Install GRUB on a device.
7
8
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
20
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
26
28 --modules=MODULES
29 Pre-load modules specified by MODULES.
30
31
32 --install-modules=MODULES
33 Install only MODULES and their dependencies. The default is to
34 install all available modules.
35
36
37 --themes=THEMES
38 Install THEMES. The default is to install the starfield theme,
39 if available.
40
41
42 --fonts=FONTS
43 Install FONTS. The default is to install the unicode font.
44
45
46 --locales=LOCALES
47 Install only locales listed in LOCALES. The default is to
48 install all available locales.
49
50
51 --compress=no,xz,gz,lzo
52 Compress GRUB files using the specified compression algorithm.
53
54
55 --directory=DIR
56 Use images and modules in DIR.
57
58
59 --grub-mkimage=FILE
60 Use FILE as grub-mkimage. The default is /usr/bin/grub-mkimage.
61
62
63 --boot-directory=DIR
64 Use DIR as the boot directory. The default is /boot. GRUB will
65 put its files in a subdirectory of this directory named grub.
66
67
68 --target=TARGET
69 Install GRUB for TARGET platform. The default is the platform
70 grub-install is running on.
71
72
73 --grub-setup=FILE
74 Use FILE as grub-setup. The default is /usr/bin/grub-setup.
75
76
77 --grub-mkrelpath=FILE
78 Use FILE as grub-mkrelpath. The default is /usr/bin/grub-mkrel‐
79 path.
80
81
82 --grub-probe=FILE
83 Use FILE as grub-probe. The default is /usr/bin/grub-mkrelpath.
84
85
86 --allow-floppy
87 Make the device also bootable as a floppy. This option is the
88 default for /dev/fdX devices. Some BIOSes will not boot images
89 created with this option.
90
91
92 --recheck
93 Delete any existing device map and create a new one if neces‐
94 sary.
95
96
97 --force
98 Install even if problems are detected.
99
100
101 --force-file-id
102 Use identifier file even if UUID is available.
103
104
105 --disk-module=MODULE
106 Use MODULE for disk access. This allows you to manually specify
107 either biosdisk or native disk access. This option is only
108 available on the BIOS target platform.
109
110
111 --no-nvram
112 Do not update the boot-device NVRAM variable. This option is
113 only available on IEEE1275 target platforms.
114
115
116 --removable
117 Treat the target device as if it is removeable. This option is
118 only available on the EFI target platform.
119
120
121 --bootloader-id=ID
122 Use ID as the bootloader ID. This opption is only available on
123 the EFI target platform.
124
125
126 --efi-directory=DIR
127 Use DIR as the EFI System Partition root. This opption is only
128 available on the EFI ta rget platform.
129
130
131 INSTALL_DEVICE
132 Install GRUB to the block device INSTALL_DEVICE.
133
134
136 info grub
137
138
139
140 Wed Feb 26 2014 GRUB-INSTALL(1)