COMPOSER-CLI(1)

πŸ’– COMPOSER-CLI πŸ’–

okay bestie, welcome to the composer-cli manual, page one of your new obsession ✨ this particular page is all about composer-cli-blueprints-push β€” yes, the one that shoves your TOML blueprint file up onto the server πŸ¦‹


🌸 NAME 🌸

composer-cli-blueprints-push β€” push the TOML blueprint file to the server πŸ’…


✨ SYNOPSIS ✨

composer-cli blueprints push BLUEPRINT [flags]

like. that's it. that's the whole vibe. BLUEPRINT is your file, [flags] is where the optional little extras go πŸŽ€


🫢 DESCRIPTION 🫢

So basically: this pushes the TOML blueprint file to the server, and it overwrites the previous version. no cap, the old one is GONE. gone gone. πŸ‘‘

And here's the part where you need to actually pay attention, bestie, because the version string does a little dance:

  • If the version string in the new blueprint matches the one on the server, the .z value gets incremented.
  • If it does not match, it will be used as-is.

that's the whole rule. the server is not going to be nice about it, it just does the thing 😭


πŸ’… OPTIONS πŸ’…

  • -h, --help[=false] β€” help for push. your little emergency exit when you're like "wait what does this do again" πŸ™ˆ

πŸ‘‘ OPTIONS INHERITED FROM PARENT COMMANDS πŸ‘‘

these bad boys come down from the parent command, so they work here too, they're just living their main character energy upstairs:

  • -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.
  • --timeout=240 β€” Timeout to use for server communication. Set to 0 for no timeout
  • --weldr-only[=false] β€” Only use the WELDR API; skip using the newer Cloud API
fr fr do not sleep on --timeout. 0 means no timeout at all, which is giving "we'll wait forever, bestie" πŸ’€

🌈 EXAMPLE 🌈

composer-cli blueprints push tmux-image.toml

iconic. ate. no notes. πŸ“


πŸ¦‹ SEE ALSO πŸ¦‹


⭐ HISTORY ⭐

  • 28-Apr-2026 β€” Auto generated by spf13/cobra

and that's the page, bestie!! this whole thing is from the composer-cli manual, dated Apr 2026 β€” go forth and push your blueprints, you absolute legend πŸ§šπŸ’œ

πŸ“¦ where this page comes from