From 2dd8fd2d2ac5f7b7a536f9d8a555bb441f4b0eaa Mon Sep 17 00:00:00 2001 From: Stanislav Zhuk Date: Fri, 10 Apr 2026 17:52:42 +0300 Subject: [PATCH 1/3] chore: Move Buildx update to v1.25.3 to get more testing time --- src/content/blog/docker-buildx-requirement-v1-25-1.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/content/blog/docker-buildx-requirement-v1-25-1.md b/src/content/blog/docker-buildx-requirement-v1-25-1.md index 9624e874..693399df 100644 --- a/src/content/blog/docker-buildx-requirement-v1-25-1.md +++ b/src/content/blog/docker-buildx-requirement-v1-25-1.md @@ -1,6 +1,8 @@ --- title: "DDEV v1.25.1 Docker Buildx Requirement" pubDate: 2026-03-05 +modifiedDate: 2026-02-17 +modifiedComment: Move Buildx update to v1.25.3 to get more testing time. summary: Why DDEV v1.25.1 requires Docker Buildx, who's affected, and how to resolve configuration issues. author: Stas Zhuk featureImage: @@ -10,7 +12,7 @@ categories: - DevOps --- -DDEV v1.25.1 introduced validation that checks for Docker Buildx, and you may encounter an error when running `ddev start` if your system isn't configured correctly. This post explains why this dependency exists, who's affected, and how to resolve it. Note that DDEV v1.25.2 will bundle a private Docker Buildx to eliminate this configuration requirement. +DDEV v1.25.1 introduced validation that checks for Docker Buildx, and you may encounter an error when running `ddev start` if your system isn't configured correctly. This post explains why this dependency exists, who's affected, and how to resolve it. Note that DDEV v1.25.3 will bundle a private Docker Buildx to eliminate this configuration requirement. ## Table of Contents @@ -102,7 +104,7 @@ NixOS users should track [DDEV issue #8183](https://github.com/ddev/ddev/issues/ ### Generic Solution -If the platform-specific solutions above don't work, you can manually place the `docker-buildx` binary in one of Docker's expected plugin directories: +If the platform-specific solutions above don't work, you can manually place the `docker-buildx` [binary](https://github.com/docker/buildx#installing) in one of Docker's expected plugin directories: **Linux/macOS:** @@ -131,7 +133,7 @@ Alternatively, place the binary anywhere and configure Docker to find it by addi We're working to make this smoother in upcoming releases: -**DDEV v1.25.2** (upcoming) will likely bundle a private Docker Buildx that DDEV uses exclusively. This eliminates the system configuration requirement for most users. I'm working on this in [PR #8198](https://github.com/ddev/ddev/pull/8198). +**DDEV v1.25.3** (upcoming) will bundle a private Docker Buildx that DDEV uses exclusively. This eliminates the system configuration requirement for most users. I'm working on this in [PR #8198](https://github.com/ddev/ddev/pull/8198). **Future releases** will transition from our private Docker Compose binary to the Docker Compose SDK. This gives DDEV more control over upstream dependencies and reduces configuration complexity. From 944f7363532bc022d24f8e6063ec4a29b234a3db Mon Sep 17 00:00:00 2001 From: Stanislav Zhuk Date: Fri, 10 Apr 2026 17:59:48 +0300 Subject: [PATCH 2/3] update nixos --- src/content/blog/docker-buildx-requirement-v1-25-1.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/content/blog/docker-buildx-requirement-v1-25-1.md b/src/content/blog/docker-buildx-requirement-v1-25-1.md index 693399df..efe61d5a 100644 --- a/src/content/blog/docker-buildx-requirement-v1-25-1.md +++ b/src/content/blog/docker-buildx-requirement-v1-25-1.md @@ -100,7 +100,10 @@ The official Docker repositories provide current versions of all Docker componen ### NixOS -NixOS users should track [DDEV issue #8183](https://github.com/ddev/ddev/issues/8183). A [NixOS patch](https://github.com/NixOS/nixpkgs/pull/494539) is available - once merged, you'll get the fix through normal system updates without manual intervention. +NixOS has already patched the `ddev` package. History: + +- [DDEV issue #8183](https://github.com/ddev/ddev/issues/8183) +- [NixOS patch](https://github.com/NixOS/nixpkgs/pull/494539) ### Generic Solution From 3c02453c36590e59d2b7b469d5382748a1d66c01 Mon Sep 17 00:00:00 2001 From: Stanislav Zhuk Date: Fri, 10 Apr 2026 18:01:55 +0300 Subject: [PATCH 3/3] fix wrong pr link --- src/content/blog/docker-buildx-requirement-v1-25-1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/blog/docker-buildx-requirement-v1-25-1.md b/src/content/blog/docker-buildx-requirement-v1-25-1.md index efe61d5a..54f3ff42 100644 --- a/src/content/blog/docker-buildx-requirement-v1-25-1.md +++ b/src/content/blog/docker-buildx-requirement-v1-25-1.md @@ -136,7 +136,7 @@ Alternatively, place the binary anywhere and configure Docker to find it by addi We're working to make this smoother in upcoming releases: -**DDEV v1.25.3** (upcoming) will bundle a private Docker Buildx that DDEV uses exclusively. This eliminates the system configuration requirement for most users. I'm working on this in [PR #8198](https://github.com/ddev/ddev/pull/8198). +**DDEV v1.25.3** will bundle a private Docker Buildx that DDEV uses exclusively. This eliminates the system configuration requirement for most users. I'm working on this in [PR #8234](https://github.com/ddev/ddev/pull/8234). **Future releases** will transition from our private Docker Compose binary to the Docker Compose SDK. This gives DDEV more control over upstream dependencies and reduces configuration complexity.