IMAGE-BUILDER-BUILD(1)

💖 IMAGE-BUILDER-BUILD(1) 💖

okay bestie, welcome to the image-builder-build manual page 💅 yes this is the image-builder-build(1) girlie, and she is about to build you an actual operating system image. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

image-builder-build — build the given image-type, e.g. qcow2 (tip: combine with --distro, --arch) 🌈

---

🎀 SYNOPSIS 🎀

image-builder build  [flags]

---

🦋 DESCRIPTION 🦋

So basically: you build the given image-type, e.g. qcow2. and the tip of all tips — combine it with --distro and --arch for maximum lewk 🌸

This command also supports uploading the image to a cloud provider after building it. build then yeet, iconic behavior ✨

For AWS uploads, credentials are read from the standard AWS credentials chain, including environment variables, shared configuration and credentials files, and instance profiles. Use --aws-profile to select a named profile. 🔥

For Azure uploads, omit both --azure-client-id and --azure-client-secret to use Azure CLI credentials after authenticating with az login. For service principal authentication, provide --azure-client-id, --azure-client-secret, and --azure-tenant. The tenant is optional with Azure CLI credentials. 💜

---

👑 OPTIONS 👑

one bullet per flag, no skipping, we respect every single one of them in this house 🫡

• --arch="" — build manifest for a different architecture
• --aws-ami-name="" — name for the AMI in AWS (only for --to=aws)
• --aws-boot-mode="" — boot mode for the AMI: legacy-bios, uefi, uefi-preferred (only for --to=aws)
• --aws-bucket="" — target S3 bucket name for intermediate storage when creating AMI (only for --to=aws)
• --aws-profile="" — name of the AWS credentials profile (only for --to=aws)
• --aws-region="" — target region for AWS uploads (only for --to=aws)
• --aws-tag=[] — tag the AMI with this Key=Value (only for --to=aws)
• --azure-client-id="" — Azure client ID (only for --to=azure)
• --azure-client-secret="" — Azure client secret (only for --to=azure)
• --azure-image-name="" — name for the uploaded image (only for --to=azure)
• --azure-resource-group="" — Azure resource group (only for --to=azure)
• --azure-subscription="" — Azure subscription ID (only for --to=azure)
• --azure-tenant="" — Azure tenant ID (only for --to=azure)
• --blueprint="" — filename of a blueprint to customize an image
• --bootc-build-ref="" — bootc build container ref
• --bootc-default-fs="" — default filesystem to use for the bootc install (e.g. ext4)
• --bootc-installer-payload-ref="" — bootc installer payload ref
• --bootc-no-default-kernel-args[=false] — don't use the default kernel arguments
• --bootc-pull-container[=false] — pull bootc container from remote location instead of using it from local container storage
• --bootc-ref="" — bootc container ref
• --bootc-variant="" — deployment variant to use for the bootc container
• --cache="/builddir/.cache/image-builder/store" — osbuild directory to cache intermediate build artifacts"
• --distro="" — build manifest for a different distroname (e.g. centos-9)
• --format="" — Output in a specific format (json)
• -h, --help[=false] — help for build 🥺
• --ibmcloud-bucket="" — target bucket name for storing the image (only for --to=ibmcloud)
• --ibmcloud-image-name="" — name for the uploaded image (only for --to=ibmcloud)
• --ibmcloud-region="" — target region for IBM Cloud uploads (only for --to=ibmcloud)
• --ignore-warnings[=false] — ignore warnings during manifest generation
• --image-size=0 — override the default image size (e.g. 1 GiB)
• --in-vm[=false] — run the osbuild pipeline in a virtual machine
• --libvirt-connection="" — connection URI (only for --to=libvirt)
• --libvirt-pool="" — pool name (only for --to=libvirt)
• --libvirt-volume="" — volume name (only for --to=libvirt)
• --openstack-container-format="bare" — this indicates if the image contains metadata about the VM (only for --to=openstack)
• --openstack-disk-format="raw" — the disk format of a virtual machine image (only for --to=openstack)
• --openstack-image="" — name for the uploaded image (only for --to=openstack)
• --ostree-parent="" — OSTREE parent
• --ostree-ref="" — OSTREE reference
• --ostree-url="" — OSTREE url
• --output-name="" — set specific output basename
• --progress="auto" — type of progress bar to use (e.g. verbose, term)
• --registrations="" — filename of a registrations file with e.g. subscription details
• --rpmmd-cache="" — osbuild directory to cache rpm metadata
• --seed=0 — rng seed, some values are derived randomly, pinning the seed allows more reproducibility if you need it. must be an integer. only used when changed.
• --with-buildlog[=false] — export osbuild buildlog
• --with-extra=[] — include an extra by type:name in the build, globs supported (e.g. --with-extra "sysext:*")
• --with-manifest[=false] — export osbuild manifest
• --with-metrics[=false] — print timing information at the end of the build
• --with-sbom[=false] — export SPDX SBOM document

---

🌟 OPTIONS INHERITED FROM PARENT COMMANDS 🌟

these ones you didn't even have to ask for, they come down from the parent command like family heirlooms 💖

• --extra-repo=[] — Add an extra repository during build (will not be gpg checked and not be part of the final image)
• --force-repo=[] — Override the base repositories during build (these will not be part of the final image)
• --force-repo-dir="" — Override the default repository search path for custom repository files
• --output-dir="" — Put output into the specified directory
• -v, --verbose[=false] — Switch to verbose mode (more logging on stderr and verbose progress)

heads up bestie: --extra-repo will not be gpg checked, and neither --extra-repo nor --force-repo will be part of the final image. read that again, it matters 💀

---

💫 SEE ALSO 💫

• image-builder(1)

---

📜 HISTORY 📜

14-Oct-2026 — Auto generated by spf13/cobra

---

and that's the whole page, you ate it all up 🍓 this was the image-builder-build(1) manual, Oct 2026, auto generated by spf13/cobra — go build something cute, love u, bye 💜🧚