WWCTL(1)

📦 version 4.7.1, in opensuse-leap 16.0

💅 WWCTL(1) — the wwctl-overlay-build era 🎀

okay bestie, so this page is all about wwctl-overlay-build, and honestly? it's the glow-up command for your nodes ✨ it's a wwctl manual page, and yes you're gonna read the whole thing, i promise it's worth it 🫶

🌸 NAME 🌸

wwctl-overlay-build — like, it does the (Re)build node overlays thing 💖 (yes the parens are canon, "Re" optional, we don't gatekeep)

✨ SYNOPSIS ✨

wwctl overlay build [OPTIONS] NODENAME...

that's it. options first (optional bestie), then a whole list of NODENAME... — plural, so you can throw multiple nodes at it 🌈

🦋 DESCRIPTION 🦋

this command builds overlays for the nodes you give it. that's the whole vibe. no cap, that's literally the description, and it's serving exactly what it needs to 👑

it's giving "i have nodes, i want overlays, i press go" 💅

🎀 OPTIONS 🎀

  • -h, --help[=false] — help for build 💖 you know the drill, ask for help and it delivers. the [=false] is just chillin' there, that's the default, don't overthink it.
  • --workers=0 — the number of parallel workers building overlays 🔥 and here's the iconic part: a value <=0 means 1 worker per CPU 👑 so 0 isn't "no workers", it's "bestie, use all my cores". do not panic. it's fine. it's slay.
lowkey important: --workers=0 does not mean zero workers. <=0 = 1 worker per CPU. periodt 💀

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

so these aren't even from build, they're inherited from the parent commands — like family traits, yk? 😭 anyway:

  • -d, --debug[=false] — run with debugging messages enabled 🐛 turn it on when you want the tea on what's actually happening.
  • -v, --verbose[=false] — run with increased verbosity 🌸 more words, more info, more vibes.
  • --warewulfconf="" — set the warewulf configuration file ⭐ default is an empty string, so it's like "you tell me where the config is, i'm not guessing".

🫶 SEE ALSO 🫶

  • wwctl-overlay(1) — the parent page, go read it, it's the main character energy this subcommand spawns from ✨

💜 HISTORY 💜

  • 16-Sep-2026 — Auto generated by spf13/cobra 🤖 yeah bestie, nobody hand-wrote this one, the machine did it and honestly it ate.
💀 reminder that this page is auto generated, so if something looks a lil rigid, that's just cobra being cobra. the facts are all here though, fr fr.

and that's the page!! 🍓 cute sign-off time: this whole thing was auto generated by spf13/cobra, dated Sep 2026, and it lives at WWCTL(1) 💅 bye bestie, go build those overlays 😭💖

📦 where this page comes from