COMPOSER-CLI(1)

📦
version 36.2 · 6 versions
, in fedora 44

💖 COMPOSER-CLI(1) 💖

okay bestie, so this is a page from the composer-cli manual — section 1, general commands, the whole thing. sit down, grab a strawberry, we're starting composes ✨

🌸 NAME 🌸

composer-cli-compose-start — Start a compose using the selected blueprint and output type 🎀

🦋 SYNOPSIS 🦋

composer-cli compose start BLUEPRINT TYPE [IMAGE-NAME PROFILE.TOML]
[flags]

✨ DESCRIPTION ✨

So you wanna start a compose using the blueprint you picked and the output type you picked. That's it, that's the vibe. Optionally you can kick off an upload too, like, bonus round.

ngl one thing you need to know: --size is supported by osbuild-composer, and it's measured in MiB. not MB. MiB. the way that matters 💅

💅 OPTIONS 💅

  • -h, --help[=false] — help for start. iconic. classic. we love her.
  • --poll="10s" — Polling interval 👀 how often she checks in on you.
  • --size=0 — Size of image in MiB 📏
  • --timeout="5m" — Maximum time to wait ⏳ she's not gonna wait forever, bestie.
  • --wait[=false] — Wait for compose to finish 🫶 the patient option.

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones came from the parent command, they're like the hand-me-downs but make it fashion ✨

  • -a, --api=1 — WELDR Server API Version to use
  • --cloudsocket="/run/cloudapi/api.socket" — Path to the cloudapi server's socket file 🔌
  • -j, --json[=false] — Output the raw JSON response instead of the normal output 🧾 for when you want the unfiltered truth
  • --log="" — Path to optional logfile 📝
  • -s, --socket="/run/weldr/api.socket" — Path to the WELDR API server's socket file 🔌
  • --test=0 — Pass test mode to compose. 1=Mock compose with fail. 2=Mock compose with finished. 🧪
  • --weldr-only[=false] — Only use the WELDR API; skip using the newer Cloud API 🌈

🌈 EXAMPLE 🌈

look at her go, main character energy fr fr:

composer-cli compose start tmux-image qcow2
composer-cli compose start tmux-image qcow2 --size 4096
composer-cli compose start tmux-image ami ami-name aws-upload.toml

🎀 SEE ALSO 🎀

composer-cli-compose(1) — go read her next, iykyk 💜

📜 HISTORY 📜

28-Apr-2026 — Auto generated by spf13/cobra. not me being literally birthed by a Go CLI framework 😭

okay that's the whole page, you ate that. this was composer-cli, from Apr 2026 — mwah, love u, go start a compose 💖✨🦋

📦 where this page comes from