Skip to content

Commit 2e91226

Browse files
dvdksnclaude
andcommitted
docs: remove stale v23 framing from BuildKit overview (fixes #24606)
The Getting started section framed Docker Engine v23.0 as a recent dividing line and included instructions for enabling BuildKit on older versions. Removed the pre-23.0 enable instructions and simplified to state that BuildKit is the default builder, with a note that Windows containers still use the legacy builder. Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 850c008 commit 2e91226

1 file changed

Lines changed: 5 additions & 37 deletions

File tree

content/manuals/build/buildkit/_index.md

Lines changed: 5 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,7 @@ keywords: build, buildkit
77

88
## Overview
99

10-
[BuildKit](https://github.com/moby/buildkit)
11-
is an improved backend to replace the legacy builder. BuildKit is the default builder
12-
for users on Docker Desktop, and Docker Engine as of version 23.0.
13-
10+
[BuildKit](https://github.com/moby/buildkit) is the builder backend used by Docker.
1411
BuildKit provides new functionality and improves your builds' performance.
1512
It also introduces support for handling more complex scenarios:
1613

@@ -73,39 +70,8 @@ BuildKit, you would
7370

7471
## Getting started
7572

76-
BuildKit is the default builder for users on Docker Desktop and Docker Engine
77-
v23.0 and later.
78-
79-
If you have installed Docker Desktop, you don't need to enable BuildKit. If you
80-
are running a version of Docker Engine version earlier than 23.0, you can enable
81-
BuildKit either by setting an environment variable, or by making BuildKit the
82-
default setting in the daemon configuration.
83-
84-
To set the BuildKit environment variable when running the `docker build`
85-
command, run:
86-
87-
```console
88-
$ DOCKER_BUILDKIT=1 docker build .
89-
```
90-
91-
> [!NOTE]
92-
>
93-
> Buildx always uses BuildKit.
94-
95-
To use Docker BuildKit by default, edit the Docker daemon configuration in
96-
`/etc/docker/daemon.json` as follows, and restart the daemon.
97-
98-
```json
99-
{
100-
"features": {
101-
"buildkit": true
102-
}
103-
}
104-
```
105-
106-
If the `/etc/docker/daemon.json` file doesn't exist, create new file called
107-
`daemon.json` and then add the following to the file. And restart the Docker
108-
daemon.
73+
BuildKit is the default builder for Docker Desktop and Docker Engine users.
74+
If you're building Windows containers, the legacy builder is used instead.
10975

11076
## BuildKit on Windows
11177

@@ -180,11 +146,13 @@ see [GitHub issues](https://github.com/moby/buildkit/issues?q=is%3Aissue%20state
180146
$Env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + `
181147
[System.Environment]::GetEnvironmentVariable("Path","User")
182148
```
149+
183150
6. Start the BuildKit daemon.
184151

185152
```console
186153
> buildkitd.exe
187154
```
155+
188156
> [!NOTE]
189157
> If you are running a _dockerd-managed_ `containerd` process, use that instead, by supplying the address:
190158
> `buildkitd.exe --containerd-worker-addr "npipe:////./pipe/docker-containerd"`

0 commit comments

Comments
 (0)