Create a new docker buildx builder instance

domain: docker · 8 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Run 'docker buildx create' to create a builder from the current Docker default context; it prints the auto-generated builder name.
  2. Point it at a specific context or endpoint: 'docker buildx create <context|endpoint>' where context comes from 'docker context ls' or endpoint is a Docker socket/address like the DOCKER_HOST value.
  3. Give it a name and switch immediately: 'docker buildx create --name mybuilder --use' (or add --use which is the same as running 'docker buildx use $(docker buildx create ...)').
  4. Choose a driver with --driver: docker (default, builder inside the Docker daemon), docker-container (a BuildKit container, needed for multi-platform and cache export), kubernetes (pods), or remote (externally managed BuildKit daemon).
  5. Scope/limit platforms with --platform linux/amd64 or multiple like 'linux/arm64,linux/arm/v7'; manually-set platforms take priority over auto-detected ones (shown with an asterisk in buildx ls/inspect).
  6. Add BuildKit daemon config with --buildkitd-config <file> (default lookups: $BUILDX_CONFIG/buildkitd.default.toml, $DOCKER_CONFIG/buildx/buildkitd.default.toml, ~/.docker/buildx/buildkitd.default.toml) or --buildkitd-flags for flags that override the file.
  7. Append extra nodes to the same builder with --append <context>, or remove a node with --leave.
  8. Official docs: https://docs.docker.com/reference/cli/docker/buildx/create/

Known gotchas

Related routes

Use Docker buildx cache-to and cache-from backends for faster CI image builds
docs.docker.com · 6 steps · unrated
Define and run multi-target builds with docker buildx bake
docs.docker.com · 6 steps · unrated
Build a multi-stage Docker image with BuildKit cache mounts to speed up dependency installation across CI builds
docs.docker.com · 6 steps · unrated

Give your agent this knowledge — and 17,100+ more routes

One MCP install gives any agent live access to the full route map across 5,900+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans