PACKIT-BUILD-IN-IMAGE-BUILDER(1)

💅 NAME 💅

okay so bestie, this is the manual page for packit-build-in-image-builder — section 1 of the manual, the packit build in-image-builder one — and it's the command that creates a VM image in Image Builder. yes, literally that. 🎀

---

✨ SYNOPSIS ✨

packit build in-image-builder [OPTIONS] IMAGE_NAME [PATH_OR_URL]

that's the whole shape of it. IMAGE_NAME is required, PATH_OR_URL is the optional little friend at the end, and the OPTIONS go wherever your heart tells you (before the name, bestie, put them before the name).

---

🦋 DESCRIPTION 🦋

So what does it do? It creates a VM image in Image Builder. That's the whole vibe. 💖

### EXPERIMENTAL ### ok so listen, no cap: this command is experimental, and the integration with Image Builder will be changed in a backwards incompatible way in the future. not "might". will. so don't build your whole personality around the current behaviour, mkay? 😭

Packit loads the image build configuration from your packit.yaml file. like, that's where it gets its whole blueprint from. 🧚

When --job-config-index is not specified, the job configuration gets loaded from your .packit.yaml and the first matching vm_image_build job is the one that gets used. first match wins, periodt.

IMAGE_NAME is the name of the image to be created. Please pick something unique so it's easy to identify for you in the Image Builder interface, and so it can be well associated with the image content. this is genuinely for your own future self's sake, bestie — you will be scrolling that interface later at 2am wondering which one is which 🙈

The [PATH_OR_URL] argument is a local path or a URL to the upstream git repository. it defaults to the current working directory, so if you're already sitting in the repo, you can just... not say anything. slay. 👑

---

🌸 OPTIONS 🌸

• --job-config-index INTEGER — use the N-th job definition to load configuration for the image build. the type needs to be vm_image_build, so don't come in here with some other job type, it's not gonna go well 💀
• --wait / --no-wait — wait for the build to finish. that's it, that's the toggle. --wait = sit there and watch it, --no-wait = go live your life 🦋
• -p, --package TEXT — which package to build, if more than one is available — like in a monorepo configuration. use it multiple times to select multiple packages. defaults to all the packages listed inside the config. so if you say nothing, you get everything, and honestly? sometimes that's the mood 🔥

---

👑 that's it, bye 👑

kisses, this was packit build in-image-builder from section 1 of the manual — version 1.16.3, dated 2026-09-04. go make a unique-named VM image, bestie, I believe in you 💜🌈🫶