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..54f3ff42 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 @@ -98,11 +100,14 @@ 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 -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 +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.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** 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.