image-builder-build - Man Page

image-builder build  [flags]

Build the given image-type, e.g. qcow2 (tip: combine with --distro, --arch)

--arch="" build manifest for a different architecture

--aws-ami-name="" name for the AMI in AWS (only for type=ami)

--aws-bucket="" target S3 bucket name for intermediate storage when creating AMI (only for type=ami)

--aws-profile="" name of the AWS credentials profile (only for type=aws)

--aws-region="" target region for AWS uploads (only for type=ami)

--aws-tag=[] tag the AMI with this Key=Value (only for type=aws)

--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-ref="" bootc container ref

--cache="/builddir/.cache/image-builder/store" osbuild directory to cache intermediate build artifacts"

--distro="" build manifest for a different distroname (e.g. centos-9)

-h, --help[=false] help for build

--ibmcloud-bucket="" target bucket name for storing the image (only for type=ibmcloud)

--ibmcloud-image-name="" name for the uploaded image (only for type=ibmcloud)

--ibmcloud-region="" target region for IBM Cloud uploads (only for type=ibmcloud)

--ignore-warnings[=false] ignore warnings during manifest generation

--in-vm[=false] run the osbuild pipeline in a virtual machine

--libvirt-connection="" connection URI (only for type=libvirt)

--libvirt-pool="" pool name (only for type=libvirt)

--libvirt-volume="" volume name (only for type=libvirt)

--openstack-container-format="bare" this indicates if the image contains metadata about the VM (only for type=openstack)

--openstack-disk-format="raw" the disk format of a virtual machine image (only for type=openstack)

--openstack-image="" name for the uploaded image (only for type=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-manifest[=false] export osbuild manifest

--with-metrics[=false] print timing information at the end of the build

--with-sbom[=false] export SPDX SBOM document

--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)

image-builder(1)

17-Jun-2026 Auto generated by spf13/cobra

image-builder(1).