Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GRUB-INSTALL(8) 	 System Administration Utilities	 GRUB-INSTALL(8)

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/local/lib/grub/<plat-
	    form>]

     --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/local/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 avail-
	    able on BIOS target.

     --efi-directory=DIR
	    use DIR as the EFI System Partition root.

     --force
	    install even if problems are detected

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

     --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]; available tar-
	    gets:  arm-efi,  arm-uboot,  arm64-efi,   i386-coreboot,   i386-efi,
	    i386-ieee1275,   i386-multiboot,   i386-pc,   i386-qemu,   i386-xen,
	    ia64-efi,  mips-arc,  mips-qemu_mips,  mipsel-arc,	mipsel-loongson,
	    mipsel-qemu_mips,  powerpc-ieee1275,  sparc64-ieee1275,  x86_64-efi,
	    x86_64-xen

     -?, --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  op-
     tional 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.

REPORTING BUGS
     Report bugs to <bug-grub@gnu.org>.

SEE ALSO
     grub-mkconfig(8), grub-mkimage(1), grub-mkrescue(1)

     The  full documentation for grub-install is maintained as a Texinfo manual.
     If the info and grub-install programs are properly installed at your  site,
     the command

	    info grub-install

     should give you access to the complete manual.

GRUB 2.02~beta2 		    June 2026			 GRUB-INSTALL(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=grub-install&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help