WWCTL(1)

💅 WWCTL(1) — the wwctl-image-syncuser era 💅

okay bestie, welcome to the WWCTL(1) page — specifically the <pink>wwctl image syncuser</pink> glow-up, and honestly? it's giving "quietly fixes your whole UID situation" energy. 🎀

---

✨ NAME ✨

wwctl-image-syncuser — synchronize UIDs/GIDs from the server to an OS image 🫶

✨ SYNOPSIS ✨

wwctl image syncuser [OPTIONS] IMAGE

✨ DESCRIPTION ✨

so the whole vibe here is: you've got UIDs and GIDs chillin' on the server, and you want them to also live inside an OS image. this command synchronizes them over, updating /etc/passwd, /etc/group, and the file ownerships within the image. no cap, it literally rewrites the who-owns-what situation in there. 💅

users and groups that exist only in the image? they get preserved — precious, protected, untouched — unless a UID/GID collision gets detected. then it's a whole thing. 😭

quick vibe check though, because this part matters:

this command affects the image itself — it's a one-time operation at build/import time. it does not magically make host users appear on your nodes at runtime.

if you want host users available on provisioned nodes at runtime too, you gotta add the "syncuser" overlay to the node or profile. both. because they're two different jobs, bestie. 🦋

✨ OPTIONS ✨

• --build[=false] — build the OS image after the syncuser step is done ✨ (default is false)
• -h, --help[=false] — the classic; prints help for syncuser 🫶 (default is false)
• --write[=true] — actually synchronize UIDs/GIDs and write the files inside the OS image 💖 (default is true, so like… it does the thing by default, iconic)

✨ OPTIONS INHERITED FROM PARENT COMMANDS ✨

• -d, --debug[=false] — run with debugging messages enabled 🌸 (default is false)
• -v, --verbose[=false] — run with increased verbosity — more words, more lore 🗣️ (default is false)
• --warewulfconf="" — set the warewulf configuration file 📁 (default is the empty string "")

✨ SEE ALSO ✨

• wwctl-image(1) — go read the parent page, it's the main character 👑

✨ HISTORY ✨

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

---

and that's the page, bestie!! 🎀 auto generated by spf13/cobra, dated Sep 2026, filed under WWCTL(1) — go sync those UIDs and slay 💅✨🌈