Build release notes
This page contains information about the new features, improvements, and bug fixes in Docker Buildx.
0.29.1
2025-10-03The 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
imagetools: Fix possible chain copy on create. docker/buildx#3447
0.29.0
2025-09-30The full release notes for this release are available on GitHub.
New
- New
--progress=noneoption 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 createcommand now supports--platformoption 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-03The 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
buildandbakecommand. dockerfile/1.18.0
Enhancements
- Add formatting options to the
buildx ducommand for custom and machine-readable output. docker/buildx#3377 - Kubernetes driver now supports
env.<key>driver opts docker/buildx#3373 - Add support for
BUILDKIT_SYNTAXbuild argument when BuildKit has a Dockerfile frontend disabled. docker/buildx#3385
Bug fixes
- Fix failing early when trying to export index annotations with moby exporter. docker/buildx#3384
- Fix possible errors on Windows from symlink handling docker/buildx#3386
0.27.0
2025-08-20The full release notes for this release are available on GitHub.
New
- Compose compatibility has been updated to v2.8.1. docker/buildx#3337
Enhancements
- DAP: Exec shell now restarts with the new container when execution resumes and pauses again. docker/buildx#3341
- DAP: Add
File Explorersection 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_NAMEbuild argument. docker/buildx#3330 - Bake now supports
homedir()function. docker/buildx#3351 - Bake default for empty Dockerfile defaults to
Dockerfileto match the behavior ofbuildcommand. docker/buildx#3347 - Bake supports
pullandno_cachefields for Compose files. docker/buildx#3352 - Sanitize the names of
additional_contextsfrom Compose files when building with Bake. docker/buildx#3361
Bug fixes
- Fix missing WSL libraries in
docker-containerdriver when GPU device is requested. docker/buildx#3320
0.26.1
2025-07-22The full release notes for this release are available on GitHub.
Bug fixes
- Fix regression when validating compose files with Bake. docker/buildx#3329
0.26.0
2025-07-21The full release notes for this release are available on GitHub.
New
- New experimental version of the DAP debugger has been added with a new
dap buildhelper command. The new feature can be tried with the DockerDX VSCode extension. docker/buildx#3235 - Compose compatibility has been updated to v2.7.1. docker/buildx#3282
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
historycommands will automatically bootstrap the builder. docker/buildx#3300- Add SLSA v1 support to
history inspectcommand. docker/buildx#3245 - Kubernetes driver option
buildkit-root-volume-memoryto use memory mount for the root volume. docker/buildx#3253
Bug fixes
- Fix possible error from
imagetoolscommands when accessing registries that don't return content length. docker/buildx#3316 - Fix duplicated command descriptions from help output. docker/buildx#3298
- Fix
history inspect attachmentto not require an argument. docker/buildx#3264 - Fix resolving environment variables from
.envfile when building compose files with Bake. docker/buildx#3275, docker/buildx#3276, docker/buildx#3322
0.25.0
2025-06-17The full release notes for this release are available on GitHub.
New
- Bake now supports defining
extra-hosts. docker/buildx#3234
Enhancements
- Add support for bearer token auth. docker/buildx#3233
- Add custom exit codes for internal, resource, and canceled errors in commands. docker/buildx#3214
- Show variable type when using
--list=variableswith Bake. docker/buildx#3207 - Consider typed, value-less variables to have
nullvalue in Bake. docker/buildx#3198 - Add support for multiple IPs in extra hosts configuration. docker/buildx#3244
- Support for updated SLSA V1 provenance in
buildx historycommands. docker/buildx#3245 - Add support for
RegistryTokenconfiguration in imagetools commands. docker/buildx#3233
Bug fixes
- Fix
keep-storageflag deprecation notice forprunecommand. docker/buildx#3216
0.24.0
2025-05-21The full release notes for this release are available on GitHub.
Enhancements
- New
typeattribute added to thevariableblock in Bake to allow explicit typing of variables. docker/buildx#3167, docker/buildx#3189, docker/buildx#3198 - New
--finalizeflag added to thehistory exportcommand to finalize build traces before exporting. docker/buildx#3152 - Compose compatibility has been updated to v2.6.3. docker/buildx#3191, docker/buildx#3171
Bug fixes
- Fix issue where some builds may leave behind temporary files after completion. docker/buildx#3133
- Fix wrong image ID returned when building with Docker when containerd-snapshotter is enabled. docker/buildx#3136
- Fix possible panic when using empty
calldefinition with Bake. docker/buildx#3168 - Fix possible malformed Dockerfile path with Bake on Windows. docker/buildx#3141
- Fix current builder not being available in JSON output for
lscommand. docker/buildx#3179 - Fix OTEL context not being propagated to Docker daemon. docker/buildx#3146
0.23.0
2025-04-15The full release notes for this release are available on GitHub.
New
- New
buildx history exportcommand allows exporting the build record into a bundle that can be imported to Docker Desktop. docker/buildx#3073
Enhancements
- New
--localand--filterflags allow filtering history records inbuildx history ls. docker/buildx#3091 - Compose compatibility has been updated to v2.6.0. docker/buildx#3080, docker/buildx#3105
- Support CLI environment variables in standalone mode. docker/buildx#3087
Bug fixes
- Fix
--printoutput for Bake producing output with unescaped variables that could cause build errors later. docker/buildx#3097 - Fix
additional_contextsfield 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-18The full release notes for this release are available on GitHub.
New
- New command
buildx history importlets you import build records into Docker Desktop for further debugging in the Build UI. This command requires Docker Desktop to be installed. docker/buildx#3039
Enhancements
- History records can now be opened by offset from the latest in
history inspect,history logsandhistory opencommands (e.g.^1). docker/buildx#3049, docker/buildx#3055 - Bake now supports the
+=operator to append when using--setfor overrides. docker/buildx#3031 - Docker container driver adds GPU devices to the container if available. docker/buildx#3063
- Annotations can now be set when using overrides with Bake. docker/buildx#2997
- NetBSD binaries are now included in the release. docker/buildx#2901
- The
inspectandcreatecommands now return an error if a node fails to boot. docker/buildx#3062
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 createcommand. Now only the final manifest pushes by tag. docker/buildx#3024
0.21.0
2025-02-19The full release notes for this release are available on GitHub.
New
- New command
buildx history tracelets you inspect traces of a build in a Jaeger UI-based viewer and compare one trace with another. docker/buildx#2904
Enhancements
- The history inspection command
buildx history inspectnow supports custom formatting with--formatflag and JSON formatting for machine-readable output. docker/buildx#2964 - Support for CDI device entitlement in build and bake. docker/buildx#2994
- Supported CDI devices are now shown in the builder inspection. docker/buildx#2983
- When using GitHub Cache backend
type=gha, the URL of the Version 2 or API is now read from the environment and sent to BuildKit. Version 2 backend requires BuildKit v0.20.0 or later. docker/buildx#2983, docker/buildx#3001
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 lscommand. 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-23The full release notes for this release are available on GitHub.
Bug fixes
- Fix
bake --printoutput 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-20The full release notes for this release are available on GitHub.
NoteThis version of buildx enables filesystem entitlement checks for
buildx bakecommand 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 settingBUILDX_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 historycommand 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
- Bake: Definition now supports new object notation for the fields that previously required CSV strings as inputs (
attest,output,cache-from,cache-to,secret,ssh). docker/buildx#2758, docker/buildx#2848, docker/buildx#2871, docker/buildx#2814 - Bake: Filesystem entitlements now error by default. To disable this behavior, you can set
BUILDX_BAKE_ENTITLEMENTS_FS=0. docker/buildx#2875 - Bake: Infer Git authentication token from remote files to build request. docker/buildx#2905
- Bake: Add support for
--listflag to list targets and variables. docker/buildx#2900, docker/buildx#2907 - Bake: Update lookup order for default definition files to load the files with "override" suffix later. docker/buildx#2886
Bug fixes
- Bake: Fix entitlements check for default SSH socket. docker/buildx#2898
- Bake: Fix missing default target in group's default targets. docker/buildx#2863
- Bake: Fix named context from target platform matching. docker/buildx#2877
- Fix missing documentation for quiet progress mode. docker/buildx#2899
- Fix missing last progress from loading layers. docker/buildx#2876
- Validate BuildKit configuration before creating a builder. docker/buildx#2864
Packaging
- Compose compatibility has been updated to v2.4.7. docker/buildx#2893, docker/buildx#2857, docker/buildx#2829
0.19.1
2024-11-27The 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-27The 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 thedocker buildx bakecommand.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
Bake definition now supports new object notation for the fields that previously required CSV strings as inputs. docker/buildx#2758
NoteThis enhancement was reverted in v0.19.1 due to a bug.
Bake definition now allows defining validation conditions to variables. docker/buildx#2794
Metadata file values can now contain JSON array values. docker/buildx#2777
Improved error messages when using an incorrect format for labels. docker/buildx#2778
FreeBSD and OpenBSD artifacts are now included in the release. docker/buildx#2774, docker/buildx#2775, docker/buildx#2781
Bug fixes
- Fixed an issue with printing Bake definitions containing empty Compose networks. docker/buildx#2790.
Packaging
- Compose support has been updated to v2.4.4. docker/buildx#2806 docker/buildx#2780.
0.18.0
2024-10-31The full release notes for this release are available on GitHub.
New
- The
docker buildx inspectcommand now displays BuildKit daemon configuration options set with a TOML file. docker/buildx#2684 - The
docker buildx lscommand output is now more compact by default by compacting the platform list. A new--no-truncoption can be used for the full list. docker/buildx#2138, docker/buildx#2717 - The
docker buildx prunecommand now supports new--max-used-spaceand--min-free-spacefilters with BuildKit v0.17.0+ builders. docker/buildx#2766
Enhancements
- Allow capturing of CPU and memory profiles with
pprofusing theBUILDX_CPU_PROFILEandBUILDX_MEM_PROFILEenvironment variables. docker/buildx#2746 - Maximum Dockerfile size from standard input has increased. docker/buildx#2716, docker/buildx#2719
- Memory allocations have been reduced. docker/buildx#2724, docker/buildx#2713
- The
--list-targetsand--list-variablesflags fordocker buildx bakeno longer require initialization of the builder. docker/buildx#2763
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
--checkand--calloptions 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
--callrequests. 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
- Compose compatibility has been updated to v2.4.1. docker/buildx#2760
0.17.1
2024-09-13The full release notes for this release are available on GitHub.
Bug fixes
- Do not set
network.hostentitlement flag automatically on builder creation for thedocker-containerandkubernetesdrivers if the entitlement is set in the BuildKit configuration file. docker/buildx#2685 - Do not print the
networkfield withdocker buildx bake --printwhen empty. docker/buildx#2689 - Fix telemetry socket path under WSL2. docker/buildx#2698
0.17.0
2024-09-10The full release notes for this release are available on GitHub.
New
- Add
basename,dirnameandsanitizefunctions to Bake. docker/buildx#2649 - Enable support for Bake entitlements to allow privileged operations during builds. docker/buildx#2666
Enhancements
- Introduce CLI metrics tracking for Bake commands. docker/buildx#2610
- Add
--debugto all build commands. Previously, it was only available on the top-leveldockeranddocker buildxcommands. docker/buildx#2660 - Allow builds from stdin for multi-node builders. docker/buildx#2656
- Improve
kubernetesdriver initialization. docker/buildx#2606 - Include target name in the error message when building multiple targets with Bake. docker/buildx#2651
- Optimize metrics handling to reduce performance overhead during progress tracking. docker/buildx#2641
- Display the number of warnings after completing a rule check. docker/buildx#2647
- Skip build ref and provenance metadata for frontend methods. docker/buildx#2650
- Add support for setting network mode in Bake files (HCL and JSON). docker/buildx#2671
- Support the
--metadata-fileflag when set along the--callflag. docker/buildx#2640 - Use shared session for local contexts used by multiple Bake targets. docker/buildx#2615, docker/buildx#2607, docker/buildx#2663
Bug fixes
- Improve memory management to avoid unnecessary allocations. docker/buildx#2601
Packaging updates
- Compose support has been updated to v2.1.6. docker/buildx#2547
0.16.2
2024-07-25The 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-18The full release notes for this release are available on GitHub.
Bug fixes
- Fix possible panic due to data race in
buildx bake --printcommand docker/buildx#2603 - Improve messaging about using
--debugflag to inspect build warnings docker/buildx#2612
0.16.0
2024-07-11The full release notes for this release are available on GitHub.
New
- Bake command now supports
--calland--checkflags andcallattribute in target definitions for selecting custom frontend methods. docker/buildx#2556, docker/buildx#2576 - Experimental
Bake now supports
--list-targetsand--list-variablesflags for inspecting the definition and possible configuration options for your project. docker/buildx#2556 - Bake definition variables and targets supports new
descriptionattribute for defining text-based description that can be inspected using e.g.--list-targetsand--list-variables. docker/buildx#2556 - Bake now supports printing warnings for build check violations. docker/buildx#2501
Enhancements
- The build command now ensures that multi-node builds use the same build reference for each node. docker/buildx#2572
- Avoid duplicate requests and improve the performance of remote driver. docker/buildx#2501
- Build warnings can now be saved to the metadata file by setting the
BUILDX_METADATA_WARNINGS=1environment variable. docker/buildx#2551, docker/buildx#2521, docker/buildx#2550 - Improve message of the
--checkflag when no warnings are detected. docker/buildx#2549
Bug fixes
- Fix support for multi-type annotations during build. docker/buildx#2522
- Fix a regression where possible inefficient transfer of files would occur when switching projects due to incremental transfer reuse. docker/buildx#2558
- Fix incorrect default load for chained Bake targets. docker/buildx#2583
- Fix incorrect
COMPOSE_PROJECT_NAMEhandling in Bake. docker/buildx#2579 - Fix index annotations support for multi-node builds. docker/buildx#2546
- Fix capturing provenance metadata for builds from remote context. docker/buildx#2560
Packaging updates
- Compose support has been updated to v2.1.3. docker/buildx#2547
0.15.1
2024-06-18The full release notes for this release are available on GitHub.
Bug fixes
- Fix missing build error and exit code for some validation requests with
--check. docker/buildx#2518 - Update fallback image for
--checkto Dockerfile v1.8.1. docker/buildx#2538
0.15.0
2024-06-11The full release notes for this release are available on GitHub.
New
New
--calloption allows setting evaluation method for a build, replacing the previous experimental--printflag. docker/buildx#2498, docker/buildx#2487, docker/buildx#2513In addition to the default
buildmethod, the following methods are implemented by Dockerfile frontend:--call=check: Run validation routines for your build configuration. For more information about build checks, see Build checks--call=outline: Show configuration that would be used by current build, including all build arguments, secrets, SSH mounts, etc., that your build would use.--call=targets: Show all available targets and their descriptions.
New
--prefer-indexflag has been added to thedocker buildx imagetools createcommand to control the behavior of creating image out of one single-platform image manifest. docker/buildx#2482The
kubernetesdriver now supports atimeoutoption for configuring deployment timeout. docker/buildx#2492New metrics definitions have been added for build warning types. docker/buildx#2482, docker/buildx#2507
The
buildx pruneandbuildx ducommands now support negative and prefix filters. docker/buildx#2473Building Compose files with Bake now supports passing SSH forwarding configuration. docker/buildx#2445
Fix issue with configuring the
kubernetesdriver with custom TLS certificates. docker/buildx#2454Fix concurrent kubeconfig access when loading nodes. docker/buildx#2497
Packaging updates
- Compose support has been updated to v2.1.2. docker/buildx#2502, docker/buildx#2425
0.14.0
2024-04-18The full release notes for this release are available on GitHub.
Enhancements
- Add support for
--print=lint(experimental). docker/buildx#2404, docker/buildx#2406 - Fix JSON formatting for custom implementations of print sub-requests in frontends. docker/buildx#2374
- Provenance records are now set when building with
--metadata-file. docker/buildx#2280 - Add Git authentication support for remote definitions. docker/buildx#2363
- New
default-loaddriver option for thedocker-container,remote, andkubernetesdrivers to load build results to the Docker Engine image store by default. docker/buildx#2259 - Add
requests.ephemeral-storage,limits.ephemeral-storageandschedulernameoptions to thekubernetesdriver. docker/buildx#2370, docker/buildx#2415 - Add
indexoffunction fordocker-bake.hclfiles. docker/buildx#2384 - OpenTelemetry metrics for Buildx now measure durations of idle time, image exports, run operations, and image transfers for image source operations during build. docker/buildx#2316, docker/buildx#2317, docker/buildx#2323, docker/buildx#2271
- Build progress metrics to the OpenTelemetry endpoint associated with the
desktop-linuxcontext no longer requires Buildx in experimental mode (BUILDX_EXPERIMENTAL=1). docker/buildx#2344
Bug fixes
- Fix
--loadand--pushincorrectly overriding outputs when used with multiple Bake file definitions. docker/buildx#2336 - Fix build from stdin with experimental mode enabled. docker/buildx#2394
- Fix an issue where delegated traces could be duplicated. docker/buildx#2362
Packaging updates
- Compose support has been updated to v2.26.1
(via
compose-gov2.0.2). docker/buildx#2391
0.13.1
2024-03-13The full release notes for this release are available on GitHub.
Bug fixes
- Fix connecting to
docker-container://andkube-pod://style URLs with remote driver. docker/buildx#2327 - Fix handling of
--pushwith Bake when a target has already defined a non-image output. docker/buildx#2330
0.13.0
2024-03-06The full release notes for this release are available on GitHub.
New
- New
docker buildx dial-stdiocommand for directly contacting BuildKit daemon of the configured builder instance. docker/buildx#2112 - Windows container builders can now be created using the
remotedriver and npipe connections. docker/buildx#2287 - Npipe URL scheme is now supported on Windows. docker/buildx#2250
- Experimental Buildx can now export OpenTelemetry metrics for build duration and transfer sizes. docker/buildx#2235, docker/buildx#2258 docker/buildx#2225 docker/buildx#2224 docker/buildx#2155
Enhancements
- Bake command now supports defining
shm-sizeandulimitvalues. docker/buildx#2279, docker/buildx#2242 - Better handling of connecting to unhealthy nodes with remote driver. docker/buildx#2130
- Builders using the
docker-containerandkubernetesdrivers now allownetwork.hostentitlement 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
--configflag fordocker buildx createwas renamed to--buildkitd-config. docker/buildx#2268 - The
--metadata-fileflag fordocker buildx buildcan now also return build reference that can be used for further build debugging, for example, in Docker Desktop. docker/buildx#2263 - The
docker buildx bakecommand now shares the same authentication provider for all targets for improved performance. docker/buildx#2147 - The
docker buildx imagetools inspectcommand now shows DSSE-signed SBOM and Provenance attestations. docker/buildx#2194 - The
docker buildx lscommand now supports--formatoptions for controlling the output. docker/buildx#1787 - The
docker-containerdriver 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-hostflag now permits a=separator for IPv6 addresses. docker/buildx#2121
Bug fixes
- Fix additional output when exporting progress with
--progress=rawjsondocker/buildx#2252 - Fix possible console warnings on Windows. docker/buildx#2238
- Fix possible inconsistent configuration merge order when using Bake with many configurations. docker/buildx#2237
- Fix possible panic in the
docker buildx imagetools createcommand. docker/buildx#2230
0.12.1
2024-01-12The full release notes for this release are available on GitHub.
Bug fixes and enhancements
- Fix incorrect validation of some
--driver-optvalues that could cause a panic and corrupt state to be stored. docker/buildx#2176
0.12.0
2023-11-16The full release notes for this release are available on GitHub.
New
- New
--annotationflag for thebuildx build, and anannotationskey in the Bake file, that lets you add OCI Annotations to build results. #2020, #2098 - New experimental debugging features, including a new
debugcommand and an interactive debugging console. This feature currently requires settingBUILDX_EXPERIMENTAL=1. #2006, #1896, #1970, #1914, #2026, #2086
Bug fixes and enhancements
- The special
host-gatewayIP mapping can now be used with the--add-hostflag 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 createcommand 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-18The full release notes for this release are available on GitHub.
Bug fixes and enhancements
- Fix a regression that caused buildx to not read the
KUBECONFIGpath 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-05The 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-parentoption 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-13The full release notes for this release are available on GitHub.
New
- Bake now supports
matrix builds.
The new matrix field on
targetlets you create multiple similar targets to remove duplication in bake files. docker/buildx#1690 - New experimental
--detachflag for running builds in detached mode. docker/buildx#1296, docker/buildx#1620, docker/buildx#1614, docker/buildx#1737, docker/buildx#1755 - New experimental debug monitor mode that lets you start a debug session in your builds. docker/buildx#1626, docker/buildx#1640
- New
EXPERIMENTAL_BUILDKIT_SOURCE_POLICYenvironment variable for applying a BuildKit source policy file. docker/buildx#1628
Bug fixes and enhancements
--loadnow 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_inlineandadditional_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 lsandbuildx inspectfor builders using thedockerdriver. docker/buildx#1552 - Display additional builder node details in buildx inspect view. docker/buildx#1440, docker/buildx#1854
- Builders using the
remotedriver allow using TLS without proving its own key/cert (if BuildKit remote is configured to support it)