Skip to content

Commit 4e4be7a

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 f05365b commit 4e4be7a

File tree

1 file changed

+4
-40
lines changed

1 file changed

+4
-40
lines changed

content/manuals/build/buildkit/_index.md

Lines changed: 4 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,8 @@ description: Introduction and overview of BuildKit
55
keywords: build, buildkit
66
---
77

8-
## Overview
9-
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-
14-
BuildKit provides improved functionality and improves your builds' performance.
8+
[BuildKit](https://github.com/moby/buildkit) is the builder backend used by Docker.
9+
BuildKit provides new functionality and improves your builds' performance.
1510
It also introduces support for handling more complex scenarios:
1611

1712
- Detect and skip executing unused build stages
@@ -72,39 +67,8 @@ BuildKit, you would
7267

7368
## Getting started
7469

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

10973
## BuildKit on Windows
11074

0 commit comments

Comments
 (0)