WWCTL(1)

🎀 WWCTL(1) 🎀

okay so real talk, bestie — this page lives in the wwctl manual (that's the WWCTL(1) vibe, iykyk), and it's all about one little subcommand that does a very big job. let's get into it 💅

✨ NAME ✨

wwctl-image-build — the "(Re)build a bootable image" queen herself. that's literally it, that's the whole name 👑

✨ SYNOPSIS ✨

wwctl image build [OPTIONS] IMAGE [...]

like, you pass IMAGE, you pass options, the magic happens. note the [...] — you can absolutely feed her more than one IMAGE, she's greedy in the best way 🫶

✨ DESCRIPTION ✨

so this command builds a bootable image from an imported IMAGE (or several — plural IMAGE(s), she contains multitudes 🌈). the "re" in "(Re)build" is doing real work here: it's build or rebuild, depending on what you need. honestly? iconic behaviour. no cap.

✨ OPTIONS ✨

• -a, --all=false — build all the images, every single one, no crumbs left behind 💀 (defaults to false)
• -f, --force[=false] — force a rebuild even when it isn't necessary. like, even if she's already built and looking cute, this makes her do it again 🔥
• -h, --help[=false] — shows the help for build. your little safety net when you forget a flag 🧚
• --syncuser[=false] — synchronize the UIDs/GIDs from the host over to the image. matching IDs, matching energy, slay ✨

ok and just so we're clear: the =false bits are the defaults, they're written right there in the flag, don't come for me 🙈

✨ OPTIONS INHERITED FROM PARENT COMMANDS ✨

these ones aren't even hers, she inherited them from the parent commands — generational wealth of flags 🎀

• -d, --debug[=false] — run with debugging messages enabled. for when you need to see everything 👀
• -v, --verbose[=false] — run with increased verbosity. more words, more info, more everything 💜
• --warewulfconf="" — sets the warewulf configuration file. give it a path, it takes a path 📁

✨ SEE ALSO ✨

• wwctl-image(1) — go say hi to the parent page, she misses you 🦋

✨ HISTORY ✨

• 16-Sep-2026 — auto generated by spf13/cobra. not a human, a machine, and honestly it ate 🤖💅

---

and that's the whole page, bestie!! stay bootable, stay booted, and remember: this whole thing was auto generated by spf13/cobra back in Sep 2026, so if the vibe is a little robot-coded, that's why 😭🫶 go build something beautiful, ily, periodt ⭐