buildx_create
Create a BuildKit builder instance to enable multi-platform builds and cache export. Optionally set it as the active builder or bootstrap it for immediate use.
Instructions
Create a new BuildKit builder instance.
Needed when the default docker driver falls short: multi-platform builds and cache export
require a docker-container (or kubernetes/remote) builder. Pass use=True to make it
the default for later buildx_build calls (else switch with buildx_use); bootstrap=True
starts the builder now rather than on first build.
Does not raise on a non-zero CLI exit — inspect returncode/stderr in the result.
args:
name - Name for the new builder (defaults to a generated name)
driver - BuildKit driver (e.g. "docker-container", "kubernetes", "remote")
driver_opts - Driver-specific options (each becomes --driver-opt KEY=VALUE)
use - Set the new builder as the current one
bootstrap - Boot the builder immediately
platforms - Platforms the builder advertises
config - Path to a buildkitd config file (copied to the target host if no local plugin);
passed as --buildkitd-config, so this argument needs buildx >= 0.17
node_name - Node name within the builder (for multi-node builders)
append - Append a node to an existing builder named name
returns: dict - {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| use | No | ||
| name | No | ||
| append | No | ||
| config | No | ||
| driver | No | ||
| bootstrap | No | ||
| node_name | No | ||
| platforms | No | ||
| driver_opts | No |