GRUB-MKNETDIR(1)

📦
version 2.12 · 6 versions
, in fedora 43, fedora 44

💖 GRUB-MKNETDIR 💖

okay bestie, so this is a page from the User Commands manual — it's grub-mknetdir, and no cap, it's the little helper that gets your GRUB netboot situation together. 🎀

🌸 NAME 🌸

grub-mknetdir — prepare a GRUB netboot directory. that's it, that's the whole job, and she does it gorgeously 💅

✨ SYNOPSIS ✨

grub-mknetdir [OPTION...]

🦋 DESCRIPTION 🦋

She prepares GRUB network boot images at net_directory/subdir, assuming net_directory is the TFTP root. that's the vibe. the whole vibe. 🔥

💜 the options (yes, all of them, we don't skip, we don't gatekeep) 💜

  • --appended-signature-size=SIZE — adds a note segment that reserves SIZE bytes for an appended signature.
  • --compress=no|xz|gz|lzo — compress the GRUB files. optional, if you feel like it. ✨
  • --disable-cli — disables command line interface access. like, the CLI said "not today" 🙈
  • --disable-shim-lock — disables the shim_lock verifier.
  • --dtb=FILE — embed one specific DTB. just the one. her one and only 💖
  • -d, --directory=DIR — use the 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 a 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 the specified modules MODULES. 🚀
  • --sbat=FILE — SBAT metadata.
  • --themes=THEMES — install THEMES. [default=starfield]
  • -v, --verbose — print verbose messages. she will literally tell you everything, main character energy 👑
  • -x, --x509key=FILE — embed FILE as an x509 certificate for signature checking.
  • --core-compress=xz|none|auto — choose the compression to use for the core image.
  • --net-directory=DIR — root directory of the TFTP server.
  • --subdir=DIR — relative subdirectory on the network server.
  • -?, --help — give this help list. 🫶
  • --usage — give a short usage message.
  • -V, --version — print program version.
⭐ heads up bestie: mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. so like, don't think the short one is exempt, fr fr.

and one more time for the people in the back: she prepares GRUB network boot images at net_directory/subdir, assuming net_directory being the TFTP root. 💀 iconic behavior honestly

😭 REPORTING BUGS 😭

found a bug? report it to <bug-grub@gnu.org>. be nice, they're doing their best 🫶

🌈 SEE ALSO 🌈

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

info grub-mknetdir

should give you access to the complete manual. go read it, i believe in you 📚✨

mwah 💋 that was GRUB 2.12, dated April 2026, and you just read the GRUB-MKNETDIR(1) page — ty for coming to my ted talk, go make some netboot images bestie 🎀🦋💖

📦 where this page comes from