{
    "mode": "man",
    "parameter": "grub-install",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/grub-install/8/json",
    "generated": "2026-06-15T13:12:47Z",
    "synopsis": "grub-install [OPTION...] [OPTION] [INSTALLDEVICE]",
    "sections": {
        "NAME": {
            "content": "grub-install - install GRUB to a device\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "grub-install [OPTION...] [OPTION] [INSTALLDEVICE]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Install GRUB on your drive.\n\n--compress=no|xz|gz|lzo\ncompress GRUB files [optional]\n",
            "subsections": [
                {
                    "name": "--disable-shim-lock",
                    "content": "disable shimlock verifier\n\n--dtb=FILE\nembed a specific DTB\n",
                    "long": "--disable-shim-lock"
                },
                {
                    "name": "-d --directory",
                    "content": "use images and modules under DIR [default=/usr/lib/grub/<platform>]\n\n--fonts=FONTS\ninstall FONTS [default=unicode]\n\n--install-modules=MODULES\ninstall only MODULES and their dependencies [default=all]\n",
                    "flag": "-d",
                    "long": "--directory"
                },
                {
                    "name": "-k --pubkey",
                    "content": "embed FILE as public key for signature checking\n\n--locale-directory=DIR use translations under DIR\n[default=/usr/share/locale]\n\n--locales=LOCALES\ninstall only LOCALES [default=all]\n\n--modules=MODULES\npre-load specified modules MODULES\n\n--sbat=FILE\nSBAT metadata\n\n--themes=THEMES\ninstall THEMES [default=starfield]\n",
                    "flag": "-k",
                    "long": "--pubkey"
                },
                {
                    "name": "-v --verbose",
                    "content": "print verbose messages.\n",
                    "flag": "-v",
                    "long": "--verbose"
                },
                {
                    "name": "--allow-floppy",
                    "content": "make  the  drive  also bootable as floppy (default for fdX devices). May break on some\nBIOSes.\n\n--boot-directory=DIR\ninstall GRUB images under the directory DIR/grub instead of the boot/grub directory\n\n--bootloader-id=ID\nthe ID of bootloader. This option is only available on EFI and Macs.\n\n--core-compress=xz|none|auto\nchoose the compression to use for core image\n\n--disk-module=MODULE\ndisk module to use (biosdisk or native). This option is only available on BIOS target.\n\n--efi-directory=DIR\nuse DIR as the EFI System Partition root.\n",
                    "long": "--allow-floppy"
                },
                {
                    "name": "--force",
                    "content": "install even if problems are detected\n",
                    "long": "--force"
                },
                {
                    "name": "--force-file-id",
                    "content": "use identifier file even if UUID is available\n\n--label-bgcolor=COLOR\nuse COLOR for label background\n\n--label-color=COLOR\nuse COLOR for label\n\n--label-font=FILE\nuse FILE as font for label\n\n--macppc-directory=DIR use DIR for PPC MAC install.\n",
                    "long": "--force-file-id"
                },
                {
                    "name": "--no-bootsector",
                    "content": "do not install bootsector\n",
                    "long": "--no-bootsector"
                },
                {
                    "name": "--no-extra-removable",
                    "content": "Do not install bootloader code to the removable media path. This option is only avail‐\nable on EFI.\n",
                    "long": "--no-extra-removable"
                },
                {
                    "name": "--no-nvram",
                    "content": "don't  update the `boot-device'/`Boot*' NVRAM variables. This option is only available\non EFI and IEEE1275 targets.\n",
                    "long": "--no-nvram"
                },
                {
                    "name": "--no-rs-codes",
                    "content": "Do not apply any reed-solomon codes when  embedding  core.img.  This  option  is  only\navailable on x86 BIOS targets.\n",
                    "long": "--no-rs-codes"
                },
                {
                    "name": "--no-uefi-secure-boot",
                    "content": "do not install an image usable with UEFI Secure Boot, even if the system was currently\nstarted using it. This option is only available on EFI.\n\n--product-version=STRING\nuse STRING as product version\n",
                    "long": "--no-uefi-secure-boot"
                },
                {
                    "name": "--recheck",
                    "content": "delete device map if it already exists\n",
                    "long": "--recheck"
                },
                {
                    "name": "--removable",
                    "content": "the installation device is removable. This option is only available on EFI.\n",
                    "long": "--removable"
                },
                {
                    "name": "-s --skip-fs-probe",
                    "content": "do not probe for filesystems in DEVICE\n\n--target=TARGET\ninstall GRUB for TARGET platform [default=i386-pc]; available  targets:  arm-coreboot,\narm-efi, arm-uboot, arm64-efi, i386-coreboot, i386-efi, i386-ieee1275, i386-multiboot,\ni386-pc,  i386-qemu,  i386-xen,  i386-xenpvh,  ia64-efi,  mips-arc,   mips-qemumips,\nmipsel-arc,    mipsel-loongson,   mipsel-qemumips,   powerpc-ieee1275,   riscv32-efi,\nriscv64-efi, sparc64-ieee1275, x8664-efi, x8664-xen\n",
                    "flag": "-s",
                    "long": "--skip-fs-probe"
                },
                {
                    "name": "--uefi-secure-boot",
                    "content": "install an image usable with UEFI Secure Boot.  This option is only available  on  EFI\nand if the grub-efi-amd64-signed package is installed.\n\n-?, --help\ngive this help list\n",
                    "long": "--uefi-secure-boot"
                },
                {
                    "name": "--usage",
                    "content": "give a short usage message\n",
                    "long": "--usage"
                },
                {
                    "name": "-V --version",
                    "content": "print program version\n\nMandatory or optional arguments to long options are also mandatory or optional for any corre‐\nsponding short options.\n\nINSTALLDEVICE must  be  system  device  filename.   grub-install  copies  GRUB  images  into\nboot/grub.  On some platforms, it may also install GRUB into the boot sector.\n",
                    "flag": "-V",
                    "long": "--version"
                }
            ]
        },
        "REPORTING BUGS": {
            "content": "Report bugs to <bug-grub@gnu.org>.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "grub-mkconfig(8), grub-mkimage(1), grub-mkrescue(1)\n\nThe  full  documentation for grub-install is maintained as a Texinfo manual.  If the info and\ngrub-install programs are properly installed at your site, the command\n\ninfo grub-install\n\nshould give you access to the complete manual.\n\n\n\nGRUB 2.06-2ubuntu7.2                        December 2022                            GRUB-INSTALL(8)",
            "subsections": []
        }
    },
    "summary": "grub-install - install GRUB to a device",
    "flags": [
        {
            "flag": "",
            "long": "--disable-shim-lock",
            "arg": null,
            "description": "disable shimlock verifier --dtb=FILE embed a specific DTB"
        },
        {
            "flag": "-d",
            "long": "--directory",
            "arg": null,
            "description": "use images and modules under DIR [default=/usr/lib/grub/<platform>] --fonts=FONTS install FONTS [default=unicode] --install-modules=MODULES install only MODULES and their dependencies [default=all]"
        },
        {
            "flag": "-k",
            "long": "--pubkey",
            "arg": null,
            "description": "embed FILE as public key for signature checking --locale-directory=DIR use translations under DIR [default=/usr/share/locale] --locales=LOCALES install only LOCALES [default=all] --modules=MODULES pre-load specified modules MODULES --sbat=FILE SBAT metadata --themes=THEMES install THEMES [default=starfield]"
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": null,
            "description": "print verbose messages."
        },
        {
            "flag": "",
            "long": "--allow-floppy",
            "arg": null,
            "description": "make the drive also bootable as floppy (default for fdX devices). May break on some BIOSes. --boot-directory=DIR install GRUB images under the directory DIR/grub instead of the boot/grub directory --bootloader-id=ID the ID of bootloader. This option is only available on EFI and Macs. --core-compress=xz|none|auto choose the compression to use for core image --disk-module=MODULE disk module to use (biosdisk or native). This option is only available on BIOS target. --efi-directory=DIR use DIR as the EFI System Partition root."
        },
        {
            "flag": "",
            "long": "--force",
            "arg": null,
            "description": "install even if problems are detected"
        },
        {
            "flag": "",
            "long": "--force-file-id",
            "arg": null,
            "description": "use identifier file even if UUID is available --label-bgcolor=COLOR use COLOR for label background --label-color=COLOR use COLOR for label --label-font=FILE use FILE as font for label --macppc-directory=DIR use DIR for PPC MAC install."
        },
        {
            "flag": "",
            "long": "--no-bootsector",
            "arg": null,
            "description": "do not install bootsector"
        },
        {
            "flag": "",
            "long": "--no-extra-removable",
            "arg": null,
            "description": "Do not install bootloader code to the removable media path. This option is only avail‐ able on EFI."
        },
        {
            "flag": "",
            "long": "--no-nvram",
            "arg": null,
            "description": "don't update the `boot-device'/`Boot*' NVRAM variables. This option is only available on EFI and IEEE1275 targets."
        },
        {
            "flag": "",
            "long": "--no-rs-codes",
            "arg": null,
            "description": "Do not apply any reed-solomon codes when embedding core.img. This option is only available on x86 BIOS targets."
        },
        {
            "flag": "",
            "long": "--no-uefi-secure-boot",
            "arg": null,
            "description": "do not install an image usable with UEFI Secure Boot, even if the system was currently started using it. This option is only available on EFI. --product-version=STRING use STRING as product version"
        },
        {
            "flag": "",
            "long": "--recheck",
            "arg": null,
            "description": "delete device map if it already exists"
        },
        {
            "flag": "",
            "long": "--removable",
            "arg": null,
            "description": "the installation device is removable. This option is only available on EFI."
        },
        {
            "flag": "-s",
            "long": "--skip-fs-probe",
            "arg": null,
            "description": "do not probe for filesystems in DEVICE --target=TARGET install GRUB for TARGET platform [default=i386-pc]; available targets: arm-coreboot, arm-efi, arm-uboot, arm64-efi, i386-coreboot, i386-efi, i386-ieee1275, i386-multiboot, i386-pc, i386-qemu, i386-xen, i386-xenpvh, ia64-efi, mips-arc, mips-qemumips, mipsel-arc, mipsel-loongson, mipsel-qemumips, powerpc-ieee1275, riscv32-efi, riscv64-efi, sparc64-ieee1275, x8664-efi, x8664-xen"
        },
        {
            "flag": "",
            "long": "--uefi-secure-boot",
            "arg": null,
            "description": "install an image usable with UEFI Secure Boot. This option is only available on EFI and if the grub-efi-amd64-signed package is installed. -?, --help give this help list"
        },
        {
            "flag": "",
            "long": "--usage",
            "arg": null,
            "description": "give a short usage message"
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "print program version Mandatory or optional arguments to long options are also mandatory or optional for any corre‐ sponding short options. INSTALLDEVICE must be system device filename. grub-install copies GRUB images into boot/grub. On some platforms, it may also install GRUB into the boot sector."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "grub-mkconfig",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/grub-mkconfig/8/json"
        },
        {
            "name": "grub-mkimage",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/grub-mkimage/1/json"
        },
        {
            "name": "grub-mkrescue",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/grub-mkrescue/1/json"
        },
        {
            "name": "GRUB-INSTALL",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/GRUB-INSTALL/8/json"
        }
    ]
}