Close Menu

    GRUB-INSTALL

    WillieBy Updated:No Comments4 Mins Read
     

    NAME

    grub-install – install GRUB to a device  

    SYNOPSIS

    grub-install [,OPTION/…] [,OPTION/] [,INSTALL_DEVICE/]  

    DESCRIPTION

    Install GRUB on your drive.
    –compress[=,no/,xz,gz,lzo]
    compress GRUB files [optional]
    -d, –directory=,DIR/
    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]
    -k, –pubkey=,FILE/
    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
    –themes=,THEMES/
    install THEMES [default=starfield]
    -v, –verbose
    print verbose messages.
    –allow-floppy
    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.
    –force
    install even if problems are detected
    –force-extra-removable
    force installation to the removable media path also. This option is only available on EFI.
    –force-file-id
    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.
    –no-bootsector
    do not install bootsector
    –no-nvram
    don’t update the `boot-device’/`Boot*’ NVRAM variables. This option is only available on EFI and IEEE1275 targets.
    –no-rs-codes
    Do not apply any reed-solomon codes when embedding core.img. This option is only available on x86 BIOS targets.
    –no-uefi-secure-boot
    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
    –recheck
    delete device map if it already exists
    –removable
    the installation device is removable. This option is only available on EFI.
    -s, –skip-fs-probe
    do not probe for filesystems in DEVICE
    Usage: grub-install [OPTION…] [OPTION] [INSTALL_DEVICE]

    Install GRUB on your drive.

    –compress[=,no/,xz,gz,lzo]
    compress GRUB files [optional]
    -d, –directory=,DIR/
    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]
    -k, –pubkey=,FILE/
    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
    –themes=,THEMES/
    install THEMES [default=starfield]
    -v, –verbose
    print verbose messages.
    –allow-floppy
    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.
    –force
    install even if problems are detected
    –force-extra-removable
    force installation to the removable media path also. This option is only available on EFI.
    –force-file-id
    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.
    –no-bootsector
    do not install bootsector
    –no-nvram
    don’t update the `boot-device’/`Boot*’ NVRAM variables. This option is only available on EFI and IEEE1275 targets.
    –no-rs-codes
    Do not apply any reed-solomon codes when embedding core.img. This option is only available on x86 BIOS targets.
    –no-uefi-secure-boot
    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
    –recheck
    delete device map if it already exists
    –removable
    the installation device is removable. This option is only available on EFI.
    -s, –skip-fs-probe
    do not probe for filesystems in DEVICE
    –target=,TARGET/
    install GRUB for TARGET platform [default=i386-pc]
    –uefi-secure-boot
    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
    –usage
    give a short usage message
    -V, –version
    print program version

    Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

    INSTALL_DEVICE 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.  

    Willie has over 15 years of experience in Linux system administration and DevOps. After managing infrastructure for startups and enterprises alike, he founded Command Linux to share the practical knowledge he wished he had when starting out. He oversees content strategy and contributes guides on server management, automation, and security.

    Related Posts