LXC.REBUILD(1)

πŸ“¦ version 5.21.6, in opensuse-leap 16.0

πŸ’… LXD - Command line client(1) πŸ’…

okay bestie, welcome to the lxc corner of the universe β€” this is the manual for the LXD command line client, and today we're hyperfixating on one specific little guy. buckle up, it's giving main character energy already ✨


🌸 NAME 🌸

lxc-rebuild β€” literally just rebuild instances. that's it. that's the whole vibe. πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

lxc rebuild [:] [:] [flags]

no cap, that's the shape of it β€” you give it stuff, you give it more stuff, and then you sprinkle [flags] on top like glitter. ✨


πŸ’– DESCRIPTION πŸ’–

Description:

so here's the tea, bestie πŸ«– β€” this command wipes the instance root disk and re-initializes it. full glow-up, factory reset, the whole thing. your instance goes bye-bye and comes back fresh.

and here's the cute part: the original image is used to re-initialize the instance β€” but only if you didn't specify a different image or --empty. so by default it's like, "okay we're redoing you the same way you were done the first time" πŸ’… no surprises, iykyk.

Note (read this one, fr fr): the --project flag sets the project for both the image remote and the instance remote. it's doing double duty, an icon πŸ‘‘ - If the image remote is a public remote (e.g. simplestreams) then this project is ignored by the image remote. it literally doesn't care. πŸ’€ - If the image remote is another LXD server, specify the source project for the image remote with --project and the instance remote with --target-project (if it's different from --project). split the duties, everyone stays happy 🫢

✨ OPTIONS ✨

  • --empty[=false] β€” rebuild as an empty instance. no image, no leftovers, just vibes and emptiness. default is false, so by default you're not doing this 🌈
  • -f, --force[=false] β€” if an instance is running, stop it and then rebuild it. we're not asking permission, we're taking the wheel πŸ”₯ default is false
  • --target-project="" β€” the project containing the instance (if different from --project). default is "" πŸŽ€

πŸ‘‘ OPTIONS INHERITED FROM PARENT COMMANDS πŸ‘‘

these aren't even this command's flags, they're inherited from the parent β€” nepo babies, but make it useful πŸ’…

  • --debug[=false] β€” show all debug messages. every last one. πŸ› default false
  • --force-local[=false] β€” force using the local unix socket. default false
  • -h, --help[=false] β€” print help. your bestie when you're lost 🫢 default false
  • --project="" β€” override the source project. default ""
  • -q, --quiet[=false] β€” don't show progress information. peaceful. silent. serene. 🧘 default false
  • --sub-commands[=false] β€” use with help or --help to view sub-commands. default false
  • -v, --verbose[=false] β€” show all information messages. the opposite of quiet, obsessed. default false
  • --version[=false] β€” print version number. know your roots ⭐ default false

πŸ” SEE ALSO πŸ”

  • lxc(1) β€” the mothership πŸ›Έ

πŸ’€ HISTORY πŸ’€

22-Aug-2026 β€” Auto generated by spf13/cobra

yeah, it's auto-generated, it said so itself, no shame in it πŸ™ˆ


and that's the whole page, bestie! literally every flag, every default, every warning, all accounted for πŸ’œ now go forth and rebuild responsibly β€” and remember, wiping a disk is forever, so maybe double-check before you hit enter 😭

kisses, and good luck out there ✨


this lil masterpiece was Auto generated by spf13/cobra πŸŽ€ β€” dated Aug 2026 β€” and yes, it still belongs to the LXD - Command line client(1) family. slay. πŸ’…

πŸ“¦ where this page comes from