WWCTL(1)

📦 version 4.7.1, in opensuse-leap 16.0

🦋 WWCTL(1) — the wwctl overlay import glow-up 🦋

okay bestie, so this is a page from the WWCTL manual (section 1, for the record) — and today's main character is wwctl-overlay-import, aka the tool that yeets a file straight into a Warewulf overlay. let's get into it 💅

✨ NAME ✨

wwctl-overlay-import — literally just: import a file into a Warewulf Overlay. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

wwctl overlay import [OPTIONS] OVERLAY_NAME FILE [NEW_NAME]

💖 DESCRIPTION 💖

so here's the tea: this command imports the FILE into the Warewulf overlay you name in OVERLAY_NAME. 🫶

and if you're feeling extra? you can optionally rename the file to NEW_NAME on the way in. iconique behavior, no notes. ⭐

🔥 OPTIONS 🔥

  • -h, --help[=false] — prints the help for import. your little safety blanket when you forget how anything works (me too, bestie).
  • -o, --overwrite[=false] — overwrites the file if it already exists. highkey useful, but like… be aware you're clobbering something. 💀
  • -p, --parents[=false] — creates any necessary parent directories for you. she builds the whole path so you don't have to 😭✨
  • --workers=0 — the number of parallel workers building overlays. and the details matter here: <=0 means 1 worker per CPU. default is 0. 👑

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these are the hand-me-downs from the parent command, and honestly they still slay:

  • -d, --debug[=false] — run with debugging messages enabled. for when you need to know everything. 🙈
  • -v, --verbose[=false] — run with increased verbosity. chattier output, same energy. 🌈
  • --warewulfconf="" — set the warewulf configuration file. empty string is the default, so it's "" if you don't say anything. 🍓

👑 SEE ALSO 👑

⭐ HISTORY ⭐

16-Sep-2026 — auto generated by spf13/cobra. yeah, the robots made this one. not me though, I just made it cute. 🦋

so that's the whole page, bestie — go import some files and be iconic about it 💅✨

signing off on behalf of the auto-generated-by-spf13/cobra gang, dated Sep 2026, page WWCTL(1) — mwah 🫶🎀💖

📦 where this page comes from