WWCTL(1)

💅 WWCTL — wwctl-node-add 💅

okay bestie, so this is a page from the WWCTL(1) manual, and today's main character is wwctl node add. it's giving "let me introduce a whole new node to Warewulf" energy, and honestly? iconic. 🎀

---

✨ NAME ✨

wwctl-node-add — Add new node to Warewulf

---

✨ SYNOPSIS ✨

wwctl node add [OPTIONS] NODENAME

---

✨ DESCRIPTION ✨

this command will add a new node named NODENAME to Warewulf. that's it, that's the whole vibe. one command, one new node, slay. 🦋

---

✨ OPTIONS ✨

okay so there are a LOT of these, but bestie we are getting through every single one. no skipping. periodt. 👑

• --asset="" — the node's Asset tag (key)
• -c, --cluster="" — cluster group
• --comment="" — arbitrary string comment
• -e, --discoverable[=] — discoverable in given network (true/false)
• --diskname="" — set diskdevice name
• --diskwipe[=] — whether or not the partition tables shall be wiped
• --fsformat="" — format of the file system
• --fsname="" — set the file system name which must match a partition name
• --fspath="" — the mount point of the file system
• --fswipe[=] — wipe file system at boot
• -G, --gateway= — the node's IPv4 network device gateway
• --gateway6= — the node's IPv6 network device gateway
• -h, --help[=false] — help for add
• -H, --hwaddr="" — the device's HW address for given network
• --image="" — image name
• -i, --init="" — the init process to boot the image
• -I, --ipaddr= — IPv4 address in given network
• --ipaddr6= — IPv6 address in given network
• --ipmiaddr= — the IPMI IP address
• --ipmiescapechar="" — the IPMI escape character (defaults: '~')
• --ipmigateway= — the IPMI gateway
• --ipmiinterface="" — the node's IPMI interface (defaults: 'lan')
• --ipminetmask= — the IPMI netmask
• --ipmipass="" — the IPMI password
• --ipmiport="" — the IPMI port
• --ipmitagadd=[] — add ipmi tags
• --ipmitemplate="" — template used for ipmi command
• --ipmiuser="" — the IPMI username
• --ipmiwrite[=] — writing of IPMI configuration (true/false)
• --ipxe="" — the iPXE template name
• -A, --kernelargs=[] — kernel arguments
• --kernelversion="" — kernel version
• --mtu="" — the MTU
• -N, --netdev="" — the device for given network
• -M, --netmask= — the network's netmask
• --netname="default" — network which is modified
• --nettagadd=[] — add network tags
• --onboot[=] — network device (true/false)
• --partcreate[=] — create the partition if it does not exist
• --partname="" — set the partition name so it can be used by a file system
• --partnumber="" — the partition number (if not set, next free slot is used)
• --partsize="" — the partition size (if not set, maximum possible size is used)
• --parttype="" — the partition type GUID
• --partwipe[=] — if true, Ignition will clobber an existing partition if it does not match the config
• --prefixlen6="" — the network's IPv6 prefix length
• -p, --primarynet="" — the primary network interface
• -P, --profile=[] — the node's profile members (comma separated)
• --root="" — the rootfs
• -R, --runtime-overlays=[] — the runtime overlay
• -O, --system-overlays=[] — the system overlay
• --tagadd=[] — add tags
• -T, --type="" — device type of given network

💀 real talk for a sec: --partwipe[=] literally says Ignition will clobber an existing partition if it doesn't match the config. that is not a drill, bestie. read it twice before you set it.

---

🌸 OPTIONS INHERITED FROM PARENT COMMANDS 🌸

these ones come from the parent command — they're the family heirlooms, yk? 🫶

• -d, --debug[=false] — Run with debugging messages enabled.
• -v, --verbose[=false] — Run with increased verbosity.
• --warewulfconf="" — Set the warewulf configuration file

---

✨ SEE ALSO ✨

wwctl-node(1) — go check out the rest of the node family, iykyk 💜

---

🎀 HISTORY 🎀

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

---

and that's the whole page, bestie!! 🥳 auto generated by spf13/cobra, dated Sep 2026, and yeah — the footer says the same thing twice because cobra is extra like that. WWCTL(1), you ate. 💅✨