Skip to content

Command Line Tools

wheels deploy build create

Create a docker buildx builder on the control machine. One-time setup for multi-arch builds and remote builds.

wheels deploy build create [--destination=<name>] [--dry-run]
FlagDescription
--destination=<name>Overlay destination config.
--dry-runPrint the commands without executing.
  • Before the first multi-arch build (builder.arch: has more than one entry).
  • Before the first build against a remote builder (builder.remote: is set).
  • Single-arch local builds don’t need build createdocker build alone suffices.

Emits docker buildx create --use ... with a name derived from the service. Idempotent — re-running uses the existing builder.

Example
wheels deploy build create