Skip to content

build: don't specify the buildx install/uninstall commands #23572

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
crazy-max merged 1 commit into from
Oct 17, 2025
Merged

build: don't specify the buildx install/uninstall commands #23572

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 5 additions & 11 deletions content/manuals/build/builders/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -78,27 +78,21 @@ older versions of the Docker CLI. The `docker buildx build` command, on the
other hand, checks whether you've set a different builder as the default
builder before it sends your build to BuildKit.

To use the `docker build` command with a non-default builder, you must either:
To use the `docker build` command with a non-default builder, you must either
specify the builder explicitly:

- Specify the builder explicitly, using the `--builder` flag or the `BUILDX_BUILDER` environment variable:
- Using the `--builder` flag:

```console
$ BUILDX_BUILDER=my_builder docker build .
$ docker build --builder my_builder .
```

- Configure Buildx as the default client by running the following command:
- Or the `BUILDX_BUILDER` environment variable:

```console
$ docker buildx install
$ BUILDX_BUILDER=my_builder docker build .
```

This updates your [Docker CLI configuration file](/reference/cli/docker/_index.md#configuration-files)
to ensure all of your build-related commands are routed via Buildx.

> [!TIP]
> To undo this change, run `docker buildx uninstall`.

Copy link
Contributor

@AkihiroSuda AkihiroSuda Oct 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe add:

> [!NOTE]
> An experimental command `docker buildx install` that allowed aliasing `docker buildx build` to `docker build` is deprecated since October 2025, and will be removed in a future release.

<!-- vale Docker.We = NO -->

In general, we recommend that you use the `docker buildx build` command when
Expand Down