COMPOSER-CLI(1)

💖 COMPOSER-CLI-BLUEPRINTS 💖

okay bestie, welcome to composer-cli-blueprints, part of the composer-cli manual set (that's the composer-cli(1) situation, iykyk) 💅

---

✨ NAME ✨

composer-cli-blueprints — manage blueprints 🎀

---

✨ SYNOPSIS ✨

composer-cli blueprints ... [flags]

---

✨ DESCRIPTION ✨

Manage blueprints on the server. that's the whole vibe, no cap 🌸

the full blueprint reference lives right here and it's lowkey iconic:

https://osbuild.org/docs/user-guide/blueprint-reference

---

✨ OPTIONS ✨

• -h, --help[=false] — help for blueprints 🫶

---

✨ OPTIONS INHERITED FROM PARENT COMMANDS ✨

these ones are the family heirlooms, passed down from the parent command 👑

• -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

---

✨ EXAMPLE ✨

okay so here's a TOML blueprint for an image with tmux, a user, and a new group for the user — literally so cute:

name = "student-image"
description = "A base system with a student account"
version = "0.0.1"

[[packages]]
name = "tmux"
version = "*"

[[customizations.user]]
name = "bart"
description = "Student account for Bart"
groups = ["students"]
password = "$6$CHO2$3rN8eviE2t50lmVyBYihTgVRHcaecmeCk31LeOUleVK/R/aeWVHVZDi26zAH.o0ywBKH9Tc0/wm7sW/q39uyd1"

[[customizations.group]]
name = "students"

and here's one for an image with a custom filesystem, because we love a bespoke /home ✨:

name = "custom-fs-image"
description = "A base system with a custom filesystem"
version = "0.0.1"

[[packages]]
name = "tmux"
version = "*"

[[customizations.filesystem]]
mountpoint = "/"
size = "2GiB"

[[customizations.filesystem]]
mountpoint = "/home"
size = "5GiB"

---

✨ SEE ALSO ✨

go read these next, bestie, it's giving ✨well-read✨:

• composer-cli(1)
• composer-cli-blueprints-changes(1)
• composer-cli-blueprints-delete(1)
• composer-cli-blueprints-depsolve(1)
• composer-cli-blueprints-diff(1)
• composer-cli-blueprints-freeze(1)
• composer-cli-blueprints-list(1)
• composer-cli-blueprints-push(1)
• composer-cli-blueprints-save(1)
• composer-cli-blueprints-show(1)
• composer-cli-blueprints-tag(1)
• composer-cli-blueprints-undo(1)
• composer-cli-blueprints-workspace(1)

---

✨ HISTORY ✨

28-Apr-2026 — Auto generated by spf13/cobra. not a human handwriting this, it's a whole machine moment 🤖💀

---

k bye ily, go manage those blueprints 💜

this was composer-cli, from Apr 2026 — mwah 🎀