IMAGE-BUILDER-UPLOAD(1)

📦
version 87.0.0 · 2 versions
, in centos-stream 10, centos-stream 9, fedora 44

💅 IMAGE-BUILDER-UPLOAD 💅

okay bestie, welcome to the image-builder-upload manual page (it's in section 1, iykyk) ✨ this is the lil guy that ships your image off to the cloud. let's get into it 🫶

✨ NAME ✨

image-builder-upload — Upload the given image from

yes the original sentence just ✨ends there✨. no cap, that's literally it. we move 💀

🌸 SYNOPSIS 🌸

image-builder upload  [flags]

(it's giving "two spaces before [flags]" and honestly? iconic, we're keeping it exactly as-is 💖)

🦋 DESCRIPTION 🦋

Upload the given image from . periodt.

☁️ AWS vibes

so for AWS uploads, your credentials get pulled from the standard AWS credentials chain — and that means environment variables, shared configuration and credentials files, and instance profiles all count. if you wanna pick a specific named profile, hit it with --aws-profile 🎀

☁️ Azure vibes

for Azure uploads, the move is: omit both --azure-client-id and --azure-client-secret and that tells it to use Azure CLI credentials — after you've authenticated with az login. slay 💅

want service principal authentication instead? then you gotta provide all three: --azure-client-id, --azure-client-secret, and --azure-tenant. and ngl, the tenant is optional when you're using Azure CLI credentials 🌈

👑 OPTIONS 👑

every single one, bestie, in order, nothing skipped 🫶

  • --arch="" — upload for the given 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)
  • --format="" — output in a specific format (yaml, json)
  • -h, --help[=false] — help for upload
  • --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)
  • --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)
  • --to="" — upload to the given cloud
heads up bestie: those ="", =[] and ="bare" bits are the defaults, shown exactly how the original shows them. don't @ me, just copy them right 💖

🧬 OPTIONS INHERITED FROM PARENT COMMANDS 🧬

the family reunion flags — they come from the parent, not from upload itself 🌸

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

🔗 SEE ALSO 🔗

  • image-builder(1) — go read your sibling's page, it's the whole family tree 💜

📜 HISTORY 📜

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

that's the whole thing, bestie, you ate that 🎀 go upload some images and be the main character of your own build pipeline 👑

Auto generated by spf13/cobra — Oct 2026 🌈✨ mwah 💋 </bold>

📦 where this page comes from