COMPOSER-CLI(1)

πŸ’Ύ composer-cli-blueprints-freeze-save β€” the manual page, bestie edition

okay so you're looking at the composer-cli manual, section 1, and this specific page is all about the blueprints freeze save command. yes the name is a whole mouthful, we love her anyway. πŸ’…


✨ NAME ✨

composer-cli-blueprints-freeze-save β€” save the frozen blueprints to a TOML file πŸ§Šβž‘οΈπŸ“„


🌸 SYNOPSIS 🌸

composer-cli blueprints freeze save BLUEPRINT,... [flags]

πŸ¦‹ DESCRIPTION πŸ¦‹

So here's the tea: this command takes your complete blueprints β€” like, with all their depsolved packages and modules already locked in πŸ”’ β€” and saves them into TOML formatted files.

And the filenames? They're named BLUEPRINT-NAME.frozen.toml. cute, consistent, iconic. πŸ‘‘


πŸ’– OPTIONS πŸ’–

  • --filename="" β€” an optional path and filename to save the blueprint into. leave it empty and she'll name it herself, no stress.
  • -h, --help[=false] β€” help for save. the classic. when in doubt, ask for help bestie 🫢

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

these ones get passed down from the parent command, like hand-me-downs but actually useful:

  • -a, --api=1 β€” the 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, no cap.
  • --log="" β€” path to an 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 it to 0 for no timeout (main character energy, honestly 😭).
  • --weldr-only[=false] β€” only use the WELDR API; skip using the newer Cloud API.

🌈 EXAMPLE 🌈

look at her go, three whole vibes:

composer-cli blueprints freeze save tmux-image
composer-cli blueprints freeze save tmux-image --filename /var/tmp/
composer-cli blueprints freeze save tmux-image --filename /var/tmp/new-tmux-image.toml

first one: just the blueprint name, let the tool do its thing ✨ second one: you gave it a directory path, living dangerously 🫣 third one: full path, full filename, fully in control, slay πŸ’…


πŸ‘€ SEE ALSO πŸ‘€


πŸ“œ HISTORY πŸ“œ

28-Apr-2026 β€” Auto generated by spf13/cobra. not a human, just a very productive robot πŸ€–


and that's the whole page, bestie!! this was composer-cli, section 1, page dated Apr 2026 β€” thanks for reading all the way to the end, you're literally the best πŸŽ€πŸ’œπŸ¦‹

πŸ“¦ where this page comes from