Build release notes

This page contains information about the new features, improvements, and bug fixes in Docker Buildx.

0.29.1

2025-10-03

The full release notes for this release are available on GitHub.

Enhancements

  • imagetools: Silence warning for empty-type mediatype used in artifacts. docker/buildx#3448

Bug fixes

0.29.0

2025-09-30

The full release notes for this release are available on GitHub.

New

  • New --progress=none option has been added. This is similar to --progress=quiet, but it does not print the image ID after image result export. docker/buildx#3431
  • Compose compatibility has been updated to v2.9.0.

Enhancements

  • imagetools create command now supports --platform option to create final image only for specified platforms. The inline attestation for the specified platforms are also kept in the final image. docker/buildx#3430
  • DAP debugger can now show the correct file explorer data when the debugger stops because of a build error. docker/buildx#3410
  • When building from a Git URL, buildx now optionally supports resolution of the context data on the client side. Git repository is still cloned on the server side, but this can help in cases where one can't be sure what version of Git URL resolution the server side supports. docker/buildx#3415

Bug fixes

  • Fix DAP debugger location resolution when there are multiple build steps with the same BuildKit digest. docker/buildx#3408

0.28.0

2025-09-03

The full release notes for this release are available on GitHub.

New

  • When building with Dockerfile version 1.18.0 or later, you can now use new Git URLs with query options for build context and named contexts in the build and bake command. dockerfile/1.18.0

Enhancements

  • Add formatting options to the buildx du command for custom and machine-readable output. docker/buildx#3377
  • Kubernetes driver now supports env.<key> driver opts docker/buildx#3373
  • Add support for BUILDKIT_SYNTAX build argument when BuildKit has a Dockerfile frontend disabled. docker/buildx#3385

Bug fixes

0.27.0

2025-08-20

The full release notes for this release are available on GitHub.

New

Enhancements

  • DAP: Exec shell now restarts with the new container when execution resumes and pauses again. docker/buildx#3341
  • DAP: Add File Explorer section to variables to inspect filesystem state. docker/buildx#3327
  • DAP: Change Dockerfile step order to match more closely with user expectations. docker/buildx#3325
  • DAP: Improve determination of the proper parent. docker/buildx#3366
  • DAP: Dockerfile nested in the context is now supported. docker/buildx#3371
  • Build name shown in history can now be overridden with BUILDKIT_BUILD_NAME build argument. docker/buildx#3330
  • Bake now supports homedir() function. docker/buildx#3351
  • Bake default for empty Dockerfile defaults to Dockerfile to match the behavior of build command. docker/buildx#3347
  • Bake supports pull and no_cache fields for Compose files. docker/buildx#3352
  • Sanitize the names of additional_contexts from Compose files when building with Bake. docker/buildx#3361

Bug fixes

  • Fix missing WSL libraries in docker-container driver when GPU device is requested. docker/buildx#3320

0.26.1

2025-07-22

The full release notes for this release are available on GitHub.

Bug fixes

0.26.0

2025-07-21

The full release notes for this release are available on GitHub.

New

Enhancements

  • Bake command now supports pattern-matching target names with wildcards. docker/buildx#3280
  • Bake command now supports setting files through environment variable BUILDX_BAKE_FILE. docker/buildx#3242
  • Bake now ignores unrelated fields when parsing and validating compose files. docker/buildx#3292
  • history commands will automatically bootstrap the builder. docker/buildx#3300
  • Add SLSA v1 support to history inspect command. docker/buildx#3245
  • Kubernetes driver option buildkit-root-volume-memory to use memory mount for the root volume. docker/buildx#3253

Bug fixes

0.25.0

2025-06-17

The full release notes for this release are available on GitHub.

New

Enhancements

Bug fixes

0.24.0

2025-05-21

The full release notes for this release are available on GitHub.

Enhancements

Bug fixes

0.23.0

2025-04-15

The full release notes for this release are available on GitHub.

New

Enhancements

Bug fixes

  • Fix --print output for Bake producing output with unescaped variables that could cause build errors later. docker/buildx#3097
  • Fix additional_contexts field not working correctly when pointing to another service. docker/buildx#3090
  • Fix empty validation block crashing the Bake HCL parser. docker/buildx#3101

0.22.0

2025-03-18

The full release notes for this release are available on GitHub.

New

Enhancements

Bug fixes

  • Fix double pushing with Docker driver when the containerd image store is enabled. docker/buildx#3023
  • Fix multiple tags being pushed for imagetools create command. Now only the final manifest pushes by tag. docker/buildx#3024

0.21.0

2025-02-19

The full release notes for this release are available on GitHub.

New

  • New command buildx history trace lets you inspect traces of a build in a Jaeger UI-based viewer and compare one trace with another. docker/buildx#2904

Enhancements

Bug fixes

  • Avoid unnecessary warnings and prompts when using --progress=rawjson. docker/buildx#2957
  • Fix regression with debug shell sometimes not working correctly on --on=error. docker/buildx#2958
  • Fix possible panic errors when using an unknown variable in the Bake definition. docker/buildx#2960
  • Fix invalid duplicate output on JSON format formatting of buildx ls command. docker/buildx#2970
  • Fix bake handling cache imports with CSV string containing multiple registry references. docker/buildx#2944
  • Fix issue where error from pulling BuildKit image could be ignored. docker/buildx#2988
  • Fix race on pausing progress on debug shell. docker/buildx#3003

0.20.1

2025-01-23

The full release notes for this release are available on GitHub.

Bug fixes

  • Fix bake --print output after missing some attributes for attestations. docker/buildx#2937
  • Fix allowing comma-separated image reference strings for cache import and export values. docker/buildx#2944

0.20.0

2025-01-20

The full release notes for this release are available on GitHub.

Note

This version of buildx enables filesystem entitlement checks for buildx bake command by default. If your Bake definition needs to read or write files outside your current working directory, you need to allow access to these paths with --allow fs=<path|*>. On the terminal, you can also interactively approve these paths with the provided prompt. Optionally, you can disable these checks by setting BUILDX_BAKE_ENTITLEMENTS_FS=0. This validation produced a warning in Buildx v0.19.0+, but starting from current release it produces an error. For more information, see the reference documentation.

New

  • New buildx history command has been added that allows working with build records of completed and running builds. You can use these commands to list, inspect, remove your builds, replay the logs of already completed builds, and quickly open your builds in Docker Desktop Build UI for further debugging. This is an early version of this command and we expect to add more features in the future releases. #2891, #2925

Enhancements

Bug fixes

Packaging

0.19.1

2024-11-27

The full release notes for this release are available on GitHub.

Bug fixes

  • Reverted the change in v0.19.0 that added new object notation for the fields that previously required CSV strings in Bake definition. This enhancement was reverted because of backwards incompatibility issues were discovered in some edge cases. This feature has now been postponed to the v0.20.0 release. docker/buildx#2824

0.19.0

2024-11-27

The full release notes for this release are available on GitHub.

New

  • Bake now requires you to allow filesystem entitlements when your build needs to read or write files outside of your current working directory. docker/buildx#2796, docker/buildx#2812.

    To allow filesystem entitlements, use the --allow fs.read=<path> flag for the docker buildx bake command.

    This feature currently only reports a warning when using a local Bake definition, but will start to produce an error starting from the v0.20 release. To enable the error in the current release, you can set BUILDX_BAKE_ENTITLEMENTS_FS=1.

Enhancements

Bug fixes

  • Fixed an issue with printing Bake definitions containing empty Compose networks. docker/buildx#2790.

Packaging

0.18.0

2024-10-31

The full release notes for this release are available on GitHub.

New

  • The docker buildx inspect command now displays BuildKit daemon configuration options set with a TOML file. docker/buildx#2684
  • The docker buildx ls command output is now more compact by default by compacting the platform list. A new --no-trunc option can be used for the full list. docker/buildx#2138, docker/buildx#2717
  • The docker buildx prune command now supports new --max-used-space and --min-free-space filters with BuildKit v0.17.0+ builders. docker/buildx#2766

Enhancements

Bug fixes

  • Check warnings now print the full filepath to the offending Dockerfile, relative to the current working directory. docker/buildx#2672
  • Fallback images for the --check and --call options have been updated to correct references. docker/buildx#2705
  • Fix issue with the build details link not showing in experimental mode. docker/buildx#2722
  • Fix validation issue with invalid target linking for Bake. docker/buildx#2700
  • Fix missing error message when running an invalid command. docker/buildx#2741
  • Fix possible false warnings for local state in --call requests. docker/buildx#2754
  • Fix potential issues with entitlements when using linked targets in Bake. docker/buildx#2701
  • Fix possible permission issues when accessing local state after running Buildx with sudo. docker/buildx#2745

Packaging

0.17.1

2024-09-13

The full release notes for this release are available on GitHub.

Bug fixes

0.17.0

2024-09-10

The full release notes for this release are available on GitHub.

New

Enhancements

Bug fixes

Packaging updates

0.16.2

2024-07-25

The full release notes for this release are available on GitHub.

Bug fixes

  • Fix possible "bad file descriptor" error when exporting local cache to NFS volume docker/buildx#2629

0.16.1

2024-07-18

The full release notes for this release are available on GitHub.

Bug fixes

0.16.0

2024-07-11

The full release notes for this release are available on GitHub.

New

  • Bake command now supports --call and --check flags and call attribute in target definitions for selecting custom frontend methods. docker/buildx#2556, docker/buildx#2576
  • Experimental Bake now supports --list-targets and --list-variables flags for inspecting the definition and possible configuration options for your project. docker/buildx#2556
  • Bake definition variables and targets supports new description attribute for defining text-based description that can be inspected using e.g. --list-targets and --list-variables. docker/buildx#2556
  • Bake now supports printing warnings for build check violations. docker/buildx#2501

Enhancements

Bug fixes

Packaging updates

0.15.1

2024-06-18

The full release notes for this release are available on GitHub.

Bug fixes

0.15.0

2024-06-11

The full release notes for this release are available on GitHub.

New

Packaging updates

0.14.0

2024-04-18

The full release notes for this release are available on GitHub.

Enhancements

Bug fixes

Packaging updates

0.13.1

2024-03-13

The full release notes for this release are available on GitHub.

Bug fixes

  • Fix connecting to docker-container:// and kube-pod:// style URLs with remote driver. docker/buildx#2327
  • Fix handling of --push with Bake when a target has already defined a non-image output. docker/buildx#2330

0.13.0

2024-03-06

The full release notes for this release are available on GitHub.

New

Enhancements

  • Bake command now supports defining shm-size and ulimit values. docker/buildx#2279, docker/buildx#2242
  • Better handling of connecting to unhealthy nodes with remote driver. docker/buildx#2130
  • Builders using the docker-container and kubernetes drivers now allow network.host entitlement by default (allowing access to the container's network). docker/buildx#2266
  • Builds can now use multiple outputs with a single command (requires BuildKit v0.13+). docker/buildx#2290, docker/buildx#2302
  • Default Git repository path is now found via configured tracking branch. docker/buildx#2146
  • Fix possible cache invalidation when using linked targets in Bake. docker/buildx#2265
  • Fixes for Git repository path sanitization in WSL. docker/buildx#2167
  • Multiple builders can now be removed with a single command. docker/buildx#2140
  • New cancellation signal handling via Unix socket. docker/buildx#2184 docker/buildx#2289
  • The Compose spec support has been updated to v2.0.0-rc.8. docker/buildx#2205
  • The --config flag for docker buildx create was renamed to --buildkitd-config. docker/buildx#2268
  • The --metadata-file flag for docker buildx build can now also return build reference that can be used for further build debugging, for example, in Docker Desktop. docker/buildx#2263
  • The docker buildx bake command now shares the same authentication provider for all targets for improved performance. docker/buildx#2147
  • The docker buildx imagetools inspect command now shows DSSE-signed SBOM and Provenance attestations. docker/buildx#2194
  • The docker buildx ls command now supports --format options for controlling the output. docker/buildx#1787
  • The docker-container driver now supports driver options for defining restart policy for BuildKit container. docker/buildx#1271
  • VCS attributes exported from Buildx now include the local directory sub-paths if they're relative to the current Git repository. docker/buildx#2156
  • --add-host flag now permits a = separator for IPv6 addresses. docker/buildx#2121

Bug fixes

0.12.1

2024-01-12

The full release notes for this release are available on GitHub.

Bug fixes and enhancements

  • Fix incorrect validation of some --driver-opt values that could cause a panic and corrupt state to be stored. docker/buildx#2176

0.12.0

2023-11-16

The full release notes for this release are available on GitHub.

New

  • New --annotation flag for the buildx build, and an annotations key in the Bake file, that lets you add OCI Annotations to build results. #2020, #2098
  • New experimental debugging features, including a new debug command and an interactive debugging console. This feature currently requires setting BUILDX_EXPERIMENTAL=1. #2006, #1896, #1970, #1914, #2026, #2086

Bug fixes and enhancements

  • The special host-gateway IP mapping can now be used with the --add-host flag during build. #1894, #2083
  • Bake now allows adding local source files when building from remote definition. #1838
  • The status of uploading build results to Docker is now shown interactively on progress bar. #1994
  • Error handling has been improved when bootstrapping multi-node build clusters. #1869
  • The buildx imagetools create command now allows adding annotation when creating new images in the registry. #1965
  • OpenTelemetry build trace delegation from buildx is now possible with Docker and Remote driver. #2034
  • Bake command now shows all files where the build definition was loaded from on the progress bar. #2076
  • Bake files now allow the same attributes to be defined in multiple definition files. #1062
  • Using the Bake command with a remote definition now allows this definition to use local Dockerfiles. #2015
  • Docker container driver now explicitly sets BuildKit config path to make sure configurations are loaded from same location for both mainline and rootless images. #2093
  • Improve performance of detecting when BuildKit instance has completed booting. #1934
  • Container driver now accepts many new driver options for defining the resource limits for BuildKit container. #2048
  • Inspection commands formatting has been improved. #2068
  • Error messages about driver capabilities have been improved. #1998
  • Improve errors when invoking Bake command without targets. #2100
  • Allow enabling debug logs with environment variables when running in standalone mode. #1821
  • When using Docker driver the default image resolve mode has been updated to prefer local Docker images for backward compatibility. #1886
  • Kubernetes driver now allows setting custom annotations and labels to the BuildKit deployments and pods. #1938
  • Kubernetes driver now allows setting authentication token with endpoint configuration. #1891
  • Fix possible issue with chained targets in Bake that could result in build failing or local source for a target uploaded multiple times. #2113
  • Fix issue when accessing global target properties when using the matrix feature of the Bake command. #2106
  • Fixes for formatting validation of certain build flags #2040
  • Fixes to avoid locking certain commands unnecessarily while booting builder nodes. #2066
  • Fix cases where multiple builds try to bootstrap the same builder instance in parallel. #2000
  • Fix cases where errors on uploading build results to Docker could be dropped in some cases. #1927
  • Fix detecting capabilities for missing attestation support based on build output. #1988
  • Fix the build for loading in Bake remote definition to not show up in build history records. #1961, #1954
  • Fix errors when building Compose files using the that define profiles with Bake. #1903
  • Fix possible time correction errors on progress bar. #1968
  • Fix passing custom cgroup parent to builds that used the new controller interface. #1913

Packaging

  • Compose support has been updated to 1.20, enabling "include" functionality when using the Bake command. #1971, #2065, #2094

0.11.2

2023-07-18

The full release notes for this release are available on GitHub.

Bug fixes and enhancements

  • Fix a regression that caused buildx to not read the KUBECONFIG path from the instance store. docker/buildx#1941
  • Fix a regression with result handle builds showing up in the build history incorrectly. docker/buildx#1954

0.11.1

2023-07-05

The full release notes for this release are available on GitHub.

Bug fixes and enhancements

  • Fix a regression for bake where services in profiles would not be loaded. docker/buildx#1903
  • Fix a regression where --cgroup-parent option had no effect during build. docker/buildx#1913
  • Fix a regression where valid docker contexts could fail buildx builder name validation. docker/buildx#1879
  • Fix a possible panic when terminal is resized during the build. docker/buildx#1929

0.11.0

2023-06-13

The full release notes for this release are available on GitHub.

New

Bug fixes and enhancements

  • --load now supports loading multi-platform images when the containerd image store is enabled. docker/buildx#1813
  • Build progress output now displays the name of the builder being used. docker/buildx#1177
  • Bake now supports detecting compose.{yml,yaml} files. docker/buildx#1752
  • Bake now supports new compose build keys dockerfile_inline and additional_contexts. docker/buildx#1784
  • Bake now supports replace HCL function. docker/buildx#1720
  • Bake now allows merging multiple similar attestation parameters into a single parameter to allow overriding with a single global value. docker/buildx#1699
  • Initial support for shell completion. docker/buildx#1727
  • BuildKit versions now correctly display in buildx ls and buildx inspect for builders using the docker driver. docker/buildx#1552
  • Display additional builder node details in buildx inspect view. docker/buildx#1440, docker/buildx#1854
  • Builders using the remote driver allow using TLS without proving its own key/cert (if BuildKit remote is configured to support it)