Skip to content

Commit 8f17f06

Browse files
authored
Merge pull request #24609 from dvdksn/fix/24606
docs: remove stale v23 framing from BuildKit overview
2 parents 0444f0f + 4f3d3f8 commit 8f17f06

File tree

1 file changed

+6
-41
lines changed

1 file changed

+6
-41
lines changed

content/manuals/build/buildkit/_index.md

Lines changed: 6 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,10 @@ 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.
15-
It also introduces support for handling more complex scenarios:
8+
[BuildKit](https://github.com/moby/buildkit) is the builder backend used by
9+
Docker. BuildKit provides improved functionality and improves your builds'
10+
performance over the legacy builder used in earlier versions of Docker. It also
11+
introduces support for handling more complex scenarios:
1612

1713
- Detect and skip executing unused build stages
1814
- Parallelize building independent build stages
@@ -72,39 +68,8 @@ BuildKit, you would
7268

7369
## Getting started
7470

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.
71+
BuildKit is the default builder for Docker Desktop and Docker Engine users.
72+
If you're building Windows containers, the legacy builder is used instead.
10873

10974
## BuildKit on Windows
11075

0 commit comments

Comments
 (0)