GRUB-MKRESCUE(1)

📦
version 2.12 · 14 versions
, in ubuntu noble

✨ GRUB-MKRESCUE(1) ✨

okay so bestie, this is the manual for grub-mkrescue — that's the User Commands girlie right there — and she's about to make you a bootable image and absolutely slay while doing it 💅

💖 NAME 💖

grub-mkrescue — make a GRUB rescue image 🎀

🌸 SYNOPSIS 🌸

grub-mkrescue [OPTION...] [OPTION] SOURCE...

🦋 DESCRIPTION 🦋

Make GRUB CD-ROM, disk, pendrive and floppy bootable image. that's it. that's the whole vibe. one tool, every medium, no cap 💀✨

💅 the options (yes, ALL of them, we're doing this) 💅

  • --compress=no|xz|gz|lzo — compress GRUB files [optional]. pick your compression bestie, or no if you simply refuse
  • --disable-shim-lock — disable shim_lock verifier 🔓
  • --dtb=FILE — embed a specific DTB, very demure, very specific
  • -d, --directory=DIR — use images and modules under DIR [default=/usr/lib/grub/<platform>]
  • --fonts=FONTS — install FONTS [default=unicode] 🎀 (yes the default is the fancy one, we love her)
  • --install-modules=MODULES — install only MODULES and their dependencies [default=all]. so like, be picky if you want
  • -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
  • --sbat=FILE — SBAT metadata
  • --themes=THEMES — install THEMES [default=starfield] ⭐ (starfield is THAT girl fr)
  • -v, --verbose — print verbose messages. like she's telling you everything that's happening, main character narration energy
  • --arcs-boot — enable ARCS (big-endian mips machines, mostly SGI) boot. Disables HFS+, APM, sparc64 and boot as disk image for i386-pc. little trade-off, no big deal 💀
  • --core-compress=xz|none|auto — choose the compression to use for core image
  • --label-bgcolor=COLOR — use COLOR for label background 🎨
  • --label-color=COLOR — use COLOR for label
  • --label-font=FILE — use FILE as font for label
  • -o, --output=FILE — save output in FILE [required]. required, bestie, don't forget her 🫶
  • --product-name=STRING — use STRING as product name
  • --product-version=STRING — use STRING as product version
  • --rom-directory=DIR — save ROM images in DIR [optional]
  • --sparc-boot — enable sparc boot. Disables HFS+, APM, ARCS and boot as disk image for i386-pc
  • --xorriso=FILE — use FILE as xorriso [optional]
  • -?, --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. like, the energy transfers, iykyk

okay so here's the actual tea ☕ — she generates a bootable CD/USB/floppy image. Arguments other than options to this program are passed to xorriso, and indicate source files, source directories, or any of the mkisofs options listed by the output of xorriso -as mkisofs -help. so yes, you're lowkey driving xorriso through her 💖

Option -- switches to native xorriso command mode. simple as that ✨

Mail xorriso support requests to <bug-xorriso@gnu.org>. 📬

😭 REPORTING BUGS 😭

Report bugs to <bug-grub@gnu.org>. she wants to hear from you (respectfully) 🙈

🔥 SEE ALSO 🔥

grub-mkimage(1)

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

info grub-mkrescue

should give you access to the complete manual. go read the full lore, it's giving director's cut 👑

GRUB 2.12-1ubuntu7.3 — March 2025 — mwah, that's a wrap bestie, go make something bootable 💜🦋🌸

📦 where this page comes from