WWCTL(1)

💅 WWCTL(1) — the wwctl image shell glow-up

okay so bestie, this is the manual page for wwctl image shell, and yeah the page is literally titled WWCTL(1) but the actual star of the show is the wwctl image shell subcommand. iykyk. let's get into it 🎀

---

✨ NAME ✨

wwctl-image-shell — Run a shell inside of a Warewulf image 🐚

like. you get a shell. inside an image. it's giving portal energy fr fr.

---

🌸 SYNOPSIS 🌸

wwctl image shell [OPTIONS] IMAGE

so it's the command, then whatever [OPTIONS] your heart desires, then the IMAGE you're diving into. that's the whole vibe check 💖

---

🦋 DESCRIPTION 🦋

Run a interactive shell inside of a warewulf IMAGE.

that's it. that's the whole thing. you point it at an image and boom — you're in there, living your best main character life inside a Warewulf image ✨ ngl it's kind of iconic.

---

🔥 OPTIONS 🔥

• -b, --bind=[] — the format is source[:destination[:{ro|copy}]] and what it does is bind a local path into the image. 🫶 huge caveat though: that local path must exist. If you don't set a destination, it just uses the same path as the source (convenient!). Now for the flavour tags: "ro" binds read-only (look but don't touch, respectful 💅), and "copy" temporarily copies the file into the image.
• --build=true — ⟨Re⟩build the image automatically. yes the angle brackets are part of the bit, it's a build OR a rebuild, she contains multitudes 🧚 and heads up, the default here is true.
• -h, --help[=false] — help for shell. the classic. the tried and true. your little escape hatch 😌
• -n, --node="" — Create a read only view of the image for the given node. read only!! no edits, just vibes 🔒 note the default is an empty string "".
• --syncuser[=false] — Synchronize UIDs/GIDs from host to image. keeping your identities matching up across the boundary, as one does 💫 defaults to false.

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones come from the parent command, so they're not even shell's own — they're heirlooms 🎀

• -d, --debug[=false] — Run with debugging messages enabled.
• -v, --verbose[=false] — Run with increased verbosity. she talks more. we love a chatty icon 🗣️
• --warewulfconf="" — Set the warewulf configuration file.

all three default to the values shown above (false, false, and an empty string "") so don't come for me if nothing yells at you right away 🙈

---

💜 SEE ALSO 💜

• wwctl-image(1) — the parent page, go say hi to the family 🌈

---

⭐ HISTORY ⭐

• 16-Sep-2026 — Auto generated by spf13/cobra.

---

okay and for the little sign-off: this whole page was auto generated by spf13/cobra, dated Sep 2026, and it's page WWCTL(1) of the manual set. no cap, that's the whole footer, wrapped in a bow 🎀💖 slay.