Docker Compose v5

_vendor/modules.txt

@@ -1,8 +1,8 @@
 # github.com/moby/moby/api v1.52.0
-# github.com/moby/buildkit v0.26.1
+# github.com/moby/buildkit v0.26.2
 # github.com/docker/buildx v0.30.1
 # github.com/docker/cli v29.1.2+incompatible
-# github.com/docker/compose/v2 v2.40.3
+# github.com/docker/compose/v5 v5.0.0
 # github.com/docker/model-runner/cmd/cli v0.1.44
 # github.com/docker/mcp-gateway v0.22.0
 # github.com/docker/scout-cli v1.18.4

content/manuals/compose/releases/release-notes.md

@@ -15,6 +15,49 @@ aliases:
 
 For more detailed information, see the [release notes in the Compose repo](https://github.com/docker/compose/releases/).
 
+## 5.0.0
+
+{{< release-date date="2025-12-02" >}}
+
+### Bug fixes and enhancements
+
+- Dropped support for internal buildkit builder.
+- Introduced Compose SDK using functional parameters.
+- Introduced abstractions to support SDK usage without requiring Docker CLI.
+- Made progress Writer a configurable CLI component.
+- Moved progress package to cmd as a CLI component.
+- Added load project function to SDK.
+- Introduced SDK docs.
+- Documented support for OCI and Git remote resources.
+- Added support for run hooks on restart.
+- Fixed check for existing image to only select the target service in run c.ommand
+- Introduced --insecure-registry, reserved for testing purpose.
+- Added support for build.no_cache_filter.
+- Added --wait option to start command.
+
+- Fixed OCI compose override support.
+- Fixed help output for "exec --no-tty" option.
+- Fixed typo in error message.
+- Disabled progress UI when build is ran with --print.
+- Restores support for detach keys.
+- Fixed images command to display image Created time.
+- Fixed  support for port range.
+- Fixed support for includes in publish command.
+- Ignore runtime flags in model configuration.
+
+### Update
+
+- Dependencies upgrade:  Bump compose go to v2.10.0
+- Dependencies upgrade: bump docker 28.5.2
+- Dependencies upgrade: bump containerd to 2.2.0
+- Dependencies upgrade: bump docker/cli to 28.5.2
+- Dependencies upgrade: bump buildx v0.30.0, buildkit v0.26.0, otel v1.38.0, otel/contrib v0.63.0
+- Dependencies upgrade: bump golang.org/x/sys 0.38.0
+- Dependencies upgrade: bump golang.org/x/sync to 0.18.0
+- Dependencies upgrade: bump github.com/hashicorp/go-version to 1.8.0
+- Dependencies upgrade: bump golang.org/x/crypto v0.45.0
+- Dockerfile: update golangci-lint to v2.6.2
+
 ## 2.40.3
 
 {{< release-date date="2025-10-30" >}}

go.mod

@@ -5,18 +5,18 @@ go 1.24.9
 require (
 	github.com/docker/buildx v0.30.1 // indirect
 	github.com/docker/cli v29.1.2+incompatible // indirect; see "replace" rule at the bottom for actual version
-	github.com/docker/compose/v2 v2.40.3 // indirect
+	github.com/docker/compose/v5 v5.0.0 // indirect
 	github.com/docker/mcp-gateway v0.22.0 // indirect
 	github.com/docker/model-runner/cmd/cli v0.1.44 // indirect
 	github.com/docker/scout-cli v1.18.4 // indirect
-	github.com/moby/buildkit v0.26.1 // indirect
+	github.com/moby/buildkit v0.26.2 // indirect
 	github.com/moby/moby/api v1.52.0 // indirect; see "replace" rule at the bottom for actual version
 )
 
 replace (
 	github.com/docker/buildx => github.com/docker/buildx v0.30.1
 	github.com/docker/cli => github.com/docker/cli v29.1.2+incompatible
-	github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.40.3
+	github.com/docker/compose/v5 => github.com/docker/compose/v5 v5.0.0
 	github.com/docker/mcp-gateway => github.com/docker/mcp-gateway v0.22.0
 	github.com/docker/model-runner/cmd/cli => github.com/docker/model-runner/cmd/cli v0.1.44
 	github.com/docker/scout-cli => github.com/docker/scout-cli v1.18.4

go.sum

@@ -10,6 +10,8 @@ github.com/docker/cli v29.1.2+incompatible h1:s4QI7drXpIo78OM+CwuthPsO5kCf8cpNsc
 github.com/docker/cli v29.1.2+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
 github.com/docker/compose/v2 v2.40.3 h1:XeYkQu1svDtyfZPv5nTwFryQ25ZJMkIlc4pz9HalMPI=
 github.com/docker/compose/v2 v2.40.3/go.mod h1:iNY1tvoHTyN3C3QHCuWAgj3OjR2T6mGkk/qxfbBF/4M=
+github.com/docker/compose/v5 v5.0.0 h1:J2uMCzJ/5xLcoIVVXvMmPe6HBzVQpmJThKa7Qk7Xldc=
+github.com/docker/compose/v5 v5.0.0/go.mod h1:BurapGv8zmYnsbSmlpCz5EU2Pi3YFV/PjeUnoFpcw64=
 github.com/docker/mcp-gateway v0.22.0 h1:l4t+HRNHxR7Jn545KDeXaeiEEhkCDBeWMTyuCaXVH7A=
 github.com/docker/mcp-gateway v0.22.0/go.mod h1:4sGoRoMeu8lj4a/HbAd/jdxXjMNVMegNnjCqmhsED+I=
 github.com/docker/model-runner/cmd/cli v0.1.44 h1:A0LBBlH8Bzjxl8CAW5tTDiqePwkNi0zNWMennQtOgt4=

hugo.yaml

@@ -127,7 +127,7 @@ params:
   # (Used to show e.g., "latest" and "latest"-1 in engine install examples
   docker_ce_version_prev: "29.1.1"
   # Latest Docker Compose version
-  compose_version: "v2.40.3"
+  compose_version: "v5.0.0"
   # Latest BuildKit version
   buildkit_version: "0.26.0"
 
@@ -323,7 +323,7 @@ module:
           target: content/reference/cli/dockerd.md
 
     # Compose
-    - path: github.com/docker/compose/v2
+    - path: github.com/docker/compose/v5
       mounts:
         - source: docs/reference
           target: data/compose-cli