COMPOSER-CLI(1)

📦
version 36.2 · 6 versions
, in fedora 44

💖 COMPOSER-CLI 💖 (that's the manual name bestie, section 1, we're in composer-cli territory)

✨ NAME ✨

composer-cli-compose-start-ostree — start an ostree compose using the blueprint and output type you picked, no cap

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

Okay so start an ostree compose using the blueprint and output type you selected. That's the whole vibe. 💅

You can optionally start an upload too, if you're feeling ambitious.

--size is supported by osbuild-composer, and is in MiB. Just so we're clear on units, because units matter and guessing is not the move.

The full details of the start-ostree command can be viewed here, and honestly go look, it's giving documentation:

https://osbuild.org/docs/on-premises/commandline/building-ostree-images

🎀 OPTIONS 🎀

  • -h, --help[=false] — help for start-ostree. Your little "what does this even do" button 🫶
  • --parent="" — OSTree parent
  • --poll="10s" — polling interval. How often we peek. 👀
  • --ref="" — OSTree reference
  • --size=0 — size of image in MiB
  • --timeout="5m" — maximum time to wait
  • --url="" — OSTree url
  • --wait[=false] — wait for compose to finish. Patience era. ⏳

💜 OPTIONS INHERITED FROM PARENT COMMANDS 💜

These came with the family, we didn't pick them, but they're iconic anyway:

  • -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
  • --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 these. Main character commands fr fr:

composer-cli compose start-ostree tmux-image fedora-iot-container
composer-cli compose start-ostree tmux-image fedora-iot-container iot-name upload.toml
composer-cli compose start-ostree --ref "rhel/edge/example" tmux-image fedora-iot-container
composer-cli compose start-ostree --ref "rhel/edge/example" --url http://10.0.2.2:8080/repo/ empty fedora-iot-installer

⭐ SEE ALSO ⭐

🧚 HISTORY 🧚

28-Apr-2026 — Auto generated by spf13/cobra. Not me writing my own lore, the tool did it. 🤖

that's the whole page bestie, go start that ostree compose, you've got this 💖✨

Sign-off vibes: this is from the composer-cli manual, dated Apr 2026, section 1. Periodt. 💅🎀🦋

📦 where this page comes from