docker · docker-tools-robot · Jun 17, 2025
@@ -1,6 +1,6 @@
 # github.com/moby/moby v28.2.1+incompatible
-# github.com/moby/buildkit v0.22.0
-# github.com/docker/buildx v0.24.0
+# github.com/moby/buildkit v0.23.0
+# github.com/docker/buildx v0.25.0
 # github.com/docker/cli v28.2.2+incompatible
 # github.com/docker/compose/v2 v2.37.1
 # github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01

diff --git a/data/buildx/docker_buildx_bake.yaml b/data/buildx/docker_buildx_bake.yaml
@@ -366,12 +366,15 @@ examples: |-
 
     ```console
     $ docker buildx bake --list=variables
-    VARIABLE      VALUE                DESCRIPTION
-    REGISTRY      docker.io/username   Registry and namespace
-    IMAGE_NAME    my-app               Image name
-    GO_VERSION    <null>
+    VARIABLE      TYPE      VALUE                DESCRIPTION
+    REGISTRY      string    docker.io/username   Registry and namespace
+    IMAGE_NAME    string    my-app               Image name
+    GO_VERSION              <null>
+    DEBUG         bool      false                Add debug symbols
     ```
 
+    Variable types will be shown when set using the `type` property in the Bake file.
+
     By default, the output of `docker buildx bake --list` is presented in a table
     format. Alternatively, you can use a long-form CSV syntax and specify a
     `format` attribute to output the list in JSON.
@@ -531,6 +534,7 @@ examples: |-
     * `context`
     * `dockerfile`
     * `entitlements`
+    * `extra-hosts`
     * `labels`
     * `load`
     * `no-cache`

diff --git a/data/buildx/docker_buildx_build.yaml b/data/buildx/docker_buildx_build.yaml
@@ -703,13 +703,15 @@ examples: |-
     Define additional build context with specified contents. In Dockerfile the context can be accessed when `FROM name` or `--from=name` is used.
     When Dockerfile defines a stage with the same name it is overwritten.
 
-    The value can be a local source directory, [local OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md), container image (with docker-image:// prefix), Git or HTTP URL.
+    The value can be a:
 
-    Replace `alpine:latest` with a pinned one:
+    - local source directory
+    - [local OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md)
+    - container image
+    - Git URL
+    - HTTP URL
 
-    ```console
-    $ docker buildx build --build-context alpine=docker-image://alpine@sha256:0123456789 .
-    ```
+    #### Use a local path {#local-path}
 
     Expose a secondary local source directory:
 
@@ -718,6 +720,16 @@ examples: |-
     # docker buildx build --build-context project=https://github.com/myuser/project.git .
     ```
 
+    #### Use a container image {#docker-image}
+
+    Use the `docker-image://` scheme.
+
+    Replace `alpine:latest` with a pinned one:
+
+    ```console
+    $ docker buildx build --build-context alpine=docker-image://alpine@sha256:0123456789 .
+    ```
+
     ```dockerfile
     # syntax=docker/dockerfile:1
     FROM alpine
@@ -726,7 +738,10 @@ examples: |-
 
     #### Use an OCI layout directory as build context {#source-oci-layout}
 
-    Source an image from a local [OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md),
+    Use the `oci-layout:///` scheme.
+
+    Source an image from a local
+    [OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md),
     either by tag, or by digest:
 
     ```console
@@ -744,7 +759,6 @@ examples: |-
     ```
 
     The OCI layout directory must be compliant with the [OCI layout specification](https://github.com/opencontainers/image-spec/blob/main/image-layout.md).
-    You can reference an image in the layout using either tags, or the exact digest.
 
     ### Override the configured builder instance (--builder) {#builder}
 

diff --git a/data/buildx/docker_buildx_debug.yaml b/data/buildx/docker_buildx_debug.yaml
@@ -1,7 +1,6 @@
 command: docker buildx debug
 short: Start debugger
 long: Start debugger
-usage: docker buildx debug
 pname: docker buildx
 plink: docker_buildx.yaml
 cname:

diff --git a/go.mod b/go.mod
@@ -3,17 +3,17 @@ module github.com/docker/docs
 go 1.24.0
 
 require (
-	github.com/docker/buildx v0.24.0 // indirect
+	github.com/docker/buildx v0.25.0 // indirect
 	github.com/docker/cli v28.2.2+incompatible // indirect
 	github.com/docker/compose/v2 v2.37.1 // indirect
 	github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01 // indirect
 	github.com/docker/scout-cli v1.15.0 // indirect
-	github.com/moby/buildkit v0.22.0 // indirect
+	github.com/moby/buildkit v0.23.0 // indirect
 	github.com/moby/moby v28.2.1+incompatible // indirect
 )
 
 replace (
-	github.com/docker/buildx => github.com/docker/buildx v0.24.0
+	github.com/docker/buildx => github.com/docker/buildx v0.25.0
 	github.com/docker/cli => github.com/docker/cli v28.2.1+incompatible
 	github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.37.1
 	github.com/docker/model-cli => github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01

diff --git a/go.sum b/go.sum
@@ -18,6 +18,8 @@ github.com/distribution/reference v0.6.0 h1:0IXCQ5g4/QMHHkarYzh5l+u8T3t73zM5Qvfr
 github.com/distribution/reference v0.6.0/go.mod h1:BbU0aIcezP1/5jX/8MP0YiH4SdvB5Y4f/wlDRiLyi3E=
 github.com/docker/buildx v0.24.0 h1:qiD+xktY+Fs3R79oz8M+7pbhip78qGLx6LBuVmyb+64=
 github.com/docker/buildx v0.24.0/go.mod h1:vYkdBUBjFo/i5vUE0mkajGlk03gE0T/HaGXXhgIxo8E=
+github.com/docker/buildx v0.25.0 h1:qs5WxBo0wQKSXcQ+v6UhWaeM2Pu+95ZCymaimRzInaE=
+github.com/docker/buildx v0.25.0/go.mod h1:xJcOeBhz49tgqN174MMGuOU4bxNmgfaLnZn7Gm641EE=
 github.com/docker/cli v28.2.1+incompatible h1:AYyTcuwvhl9dXdyCiXlOGXiIqSNYzTmaDNpxIISPGsM=
 github.com/docker/cli v28.2.1+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
 github.com/docker/compose/v2 v2.36.2 h1:rxk1PUUbhbAS6HkGsYo9xUmMBpKtVwFMNCQjE4+i5fk=