composer-cli-blueprints - Man Page
Manage blueprints
Synopsis
composer-cli blueprints ... [flags]
Description
Manage blueprints on the server
The full blueprint reference can be found here:
https://osbuild.org/docs/user-guide/blueprint-reference
Options
-h, --help[=false] help for blueprints
Options Inherited from Parent Commands
-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
TOML blueprint for an image with tmux, a user, and a new group for the user:
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"
TOML blueprint for an image with a custom filesystem:
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
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
15-Oct-2025 Auto generated by spf13/cobra
Referenced By
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).