DISTROBUILDER(1)

📦
version 3.3.1 · 4 versions
, in ubuntu stonking

✨ DISTROBUILDER(1) ✨

okay bestie, welcome to distrobuilder — the manual page, girlified, but with zero facts lost 💖 it lives in section 1 of the User Commands manual, and it's about to be your new hyperfixation.

🌸 NAME 🌸

distrobuilder — System container image builder ✨

🦋 DESCRIPTION 🦋

It's a System container and VM image builder for LXC and Incus. that's the whole vibe. it builds the images. it slays.

🎀 Usage:

distrobuilder [command]

like, you give it a command, it does the thing. iconic behaviour honestly.

👑 Available Commands 👑

  • build-dir — Build plain rootfs. just a rootfs, raw, unbothered, no packaging drama 🫶
  • build-incus — Build Incus image from scratch. from SCRATCH scratch. main character energy 🔥
  • build-lxc — Build LXC image from scratch. same energy, LXC flavour 💜
  • help — Help about any command. when you're lost, this is your emotional support subcommand 😭
  • pack-incus — Create Incus image from existing rootfs. the rootfs already exists, we're just dressing it up 💅
  • pack-lxc — Create LXC image from existing rootfs. same, but LXC 💖
  • repack-windows — Repack Windows ISO with drivers included. yep, drivers included, we're not doing that by hand, no ma'am ✨
  • validate — Validate definition file. vibe check for your YAML 🧚
lowkey the original page squished repack-windows and validate onto the same line, but bestie they are two whole separate commands and both of them are right here, promise 🤝

💅 Flags 💅

  • --cache-dir — Cache directory. where the cache lives. tell it where, it'll go there 🎀
  • --cleanup — Clean up cache directory (default true). yes bestie, it cleans up after itself by default, so if you turn it off that's a choice you made 🌸
  • --debug — Enable debug output. for when you need the tea, in full ☕
  • --disable-overlay — Disable the use of filesystem overlays. no overlays, just files, plain and simple 🦋
  • -h, --help — help for distrobuilder. your little compass 🧭
  • -o, --options — Override options (list of key=value). override city, population: you 👑
  • -t, --timeout — Timeout in seconds. patience has a unit and it's seconds ⏳
  • --version — Print version number. because sometimes you just wanna know who you're dealing with 💅

And one last lil note from the original, super important:

Use "distrobuilder [command] --help" for more information about a command.

like, every single subcommand has its own help page. go read them, they're lowkey juicy 📖

sign-off szn 💖 this was distrobuilder 3.3.1, dated May 2026, and yes it's still living its best life as the DISTROBUILDER(1) page. go build something iconic bestie 🫶✨

📦 where this page comes from