COMPOSER-CLI(1)

πŸ’– COMPOSER-CLI πŸ’–

okay bestie, gather round, because this is the composer-cli manual page and it's literally the main character of the osbuild-composer command line world ✨


🌸 NAME 🌸

composer-cli β€” the composer commandline tool, aka your new bestie for talking to composer without ever leaving the terminal πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

composer-cli [flags]

that's it. that's the whole vibe. just the command and whatever flags you wanna throw at it πŸŽ€


✨ DESCRIPTION ✨

okay so, no cap: composer-cli is a commandline tool for osbuild-composer. that's the whole description and honestly? she said what she said. πŸ‘‘


πŸ’… OPTIONS πŸ’…

the flags, the whole flags, and nothing but the flags. every single one is here, i did not skip a single one, periodt 🫢

  • -a, --api=1 β€” the WELDR Server API Version to use. default is 1, iconic of her πŸ’œ
  • --cloudsocket="/run/cloudapi/api.socket" β€” Path to the cloudapi server's socket file 🧚
  • -h, --help[=false] β€” help for composer-cli. the classic. the legend. πŸ™ˆ
  • -j, --json[=false] β€” Output the raw JSON response instead of the normal output. for when you want the unfiltered truth, fr fr πŸ”₯
  • --log="" β€” Path to optional logfile. optional, like your plans for tonight ✨
  • -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. (not me testing in prod... 😭)
  • --timeout=240 β€” Timeout to use for server communication. Set to 0 for no timeout. zero means forever, bestie, choose wisely πŸ’€
  • --weldr-only[=false] β€” Only use the WELDR API; skip using the newer Cloud API. she's old school like that πŸŽ€

πŸ‘‘ SEE ALSO πŸ‘‘

if this page ate and you want more, the whole girl squad is right here:


πŸ•°οΈ HISTORY πŸ•°οΈ

28-Apr-2026 β€” Auto generated by spf13/cobra. the bots did this one, but they did it well πŸ’–


lowkey reminder: this page is composer-cli, from Apr 2026, and yes the manpage naming convention really does put COMPOSER-CLI(1) at the top and bottom like a little sandwich πŸ₯ͺ

that's the whole page bestie, you're so welcome, go compose something gorgeous πŸŒΈπŸ¦‹πŸ’…

πŸ“¦ where this page comes from