Reference

grub-mkimage(1)

make a bootable image of GRUB

NAME

grub-mkimage - make a bootable image of GRUB

SYNOPSIS

grub-mkimage [OPTION...] [OPTION]... [MODULES]

DESCRIPTION

Make a bootable image of GRUB.

-c, --config=FILE

embed FILE as an early config

-C, --compression=(xz|none|auto)

choose the compression to use for core image

--disable-cli

disable command line interface access

--disable-shim-lock

disable shim_lock verifier

-d, --directory=DIR

use images and modules under DIR [default=/usr/lib/grub/<platform>]

-D, --dtb=FILE

embed FILE as a device tree (DTB)

-k, --pubkey=FILE

embed FILE as public key for PGP signature checking

-m, --memdisk=FILE

embed FILE as a memdisk image

Implies `-p (memdisk)/boot/grub' and overrides

any prefix supplied previously, but the prefix

itself can be overridden by later options

-n, --note

add NOTE segment for CHRP IEEE1275

-o, --output=FILE

output a generated image to FILE [default=stdout]

-O, --format=FORMAT

generate an image in FORMAT available formats: i386-coreboot, i386-multiboot, i386-pc, i386-xen_pvh, i386-pc-pxe, i386-pc-eltorito, i386-efi, i386-ieee1275, i386-qemu, x86_64-efi, i386-xen, x86_64-xen, mipsel-yeeloong-flash, mipsel-fuloong2f-flash, mipsel-loongson-elf, powerpc-ieee1275, sparc64-ieee1275-raw, sparc64-ieee1275-cdcore, sparc64-ieee1275-aout, ia64-efi, mips-arc, mipsel-arc, mipsel-qemu_mips-elf, mips-qemu_mips-flash, mipsel-qemu_mips-flash, mips-qemu_mips-elf, arm-uboot, arm-coreboot-vexpress, arm-coreboot-veyron, arm-efi, arm64-efi, loongarch64-efi, riscv32-efi, riscv64-efi

-p, --prefix=DIR

set prefix directory

-s, --sbat=FILE

SBAT metadata

-S, --appended-signature-size=SIZE

Add a note segment reserving SIZE bytes for an appended signature

-v, --verbose

print verbose messages.

-x, --x509key=FILE

embed FILE as an x509 certificate for appended signature checking

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

REPORTING BUGS

Report bugs to <[email protected]>.

SEE ALSO

grub-install(8), grub-mkrescue(1), grub-mknetdir(8)

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

info grub-mkimage

should give you access to the complete manual.

History

--appended-signature-size since Arch Linux 2026-11-01; --compression since Debian 7 (Wheezy); --config since Debian 6.0 (Squeeze); --directory since Debian 6.0 (Squeeze); --disable-cli since Arch Linux 2026-11-01; --disable-shim-lock since Debian 10 (Buster); --dtb since Debian 10 (Buster); --format since Debian 6.0 (Squeeze); --help since Debian 6.0 (Squeeze); --memdisk since Debian 6.0 (Squeeze); --note since Debian 6.0 (Squeeze); --output since Debian 6.0 (Squeeze); --prefix since Debian 6.0 (Squeeze); --pubkey since Debian 8 (Jessie); --sbat since Debian 10 (Buster); --usage since Debian 8 (Jessie); --verbose since Debian 6.0 (Squeeze); --version since Debian 6.0 (Squeeze); --x509key since Arch Linux 2026-11-01; -? since Debian 8 (Jessie); -C since Debian 7 (Wheezy); -D since Debian 10 (Buster); -O since Debian 6.0 (Squeeze); -S since Arch Linux 2026-11-01; -V since Debian 6.0 (Squeeze); -c since Debian 6.0 (Squeeze); -d since Debian 6.0 (Squeeze); -k since Debian 8 (Jessie); -m since Debian 6.0 (Squeeze); -n since Debian 6.0 (Squeeze); -o since Debian 6.0 (Squeeze); -p since Debian 6.0 (Squeeze); -s since Debian 10 (Buster); -v since Debian 6.0 (Squeeze); -x since Arch Linux 2026-11-01.

--font until Debian 6.0 (Squeeze); -f until Debian 6.0 (Squeeze); -h until Debian 7 (Wheezy).