From 9896a7d29700911dae3da005d815252103eaf9c8 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Fri, 22 May 2026 11:10:01 +0200 Subject: [PATCH] sbx: clarify that buildx create --driver cloud connects to existing builder MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a note to the Docker Build Cloud setup steps clarifying that `docker buildx create --driver cloud` connects Buildx to an existing cloud builder created on the dashboard — it does not provision a new one. Fixes #25150 Co-Authored-By: Claude Sonnet 4.6 --- content/manuals/build-cloud/setup.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/content/manuals/build-cloud/setup.md b/content/manuals/build-cloud/setup.md index 56f78180c42d..88aca9d035b8 100644 --- a/content/manuals/build-cloud/setup.md +++ b/content/manuals/build-cloud/setup.md @@ -45,7 +45,7 @@ command, or using the Docker Desktop settings GUI. $ docker login ``` -2. Add the cloud builder endpoint. +2. Connect Buildx to your cloud builder. ```console $ docker buildx create --driver cloud / @@ -53,16 +53,22 @@ command, or using the Docker Desktop settings GUI. Replace `` with the Docker Hub namespace of your Docker organization (or your username if you are using a personal account), and `` with the name you chose when creating the builder in the dashboard. - This creates a local instance of the cloud builder named `cloud-ORG-BUILDER_NAME`. + This registers a local endpoint for the cloud builder named `cloud-ORG-BUILDER_NAME`. + + > [!NOTE] + > + > This command connects Buildx to an existing Docker Build Cloud builder. It + > does not create a new cloud builder. To add a new builder, use the + > [Docker Build Cloud Dashboard](https://app.docker.com/build/). > [!NOTE] > > If your organization is `acme` and you named your builder `default`, use: + > > ```console > $ docker buildx create --driver cloud acme/default > ``` - {{< /tab >}} {{< tab name="Docker Desktop" >}}