What's Changed

🐛 Fixes

• emit container status events after network reconnection (fixes #13524) by @MaheshThakur9152 in #13529
• Fix potential nil pointer dereference in container event monitoring by @Nepomuk5665 in #13551
• compose: recreate container when mounted image digest changes by @ibrahimypr in #13549
• fix panic by @ndeloof in #13562
• Fix invalid path error when using OCI artifacts on Windows by @mikesir87 in #13574
• fix: execute post_start hooks in docker compose run by @veeceey in #13607
• Fix panic when watch rebuilds without up by @maxproske in #13610

🔧 Internal

• fsnotify is set in Dockerfile by @ndeloof in #13533
• Dockerfile: update golangci-lint to v2.8.0 by @thaJeztah in #13535
• replace some uses of strings.Split(N) for strings.Cut by @thaJeztah in #13542
• Upgrade GitHub Actions to latest versions by @salmanmkc in #13546
• pkg/compose: remove dependency on github.com/docker/buildx/driver by @thaJeztah in #13563
• use Docker GitHub Builder to build and sign binaries and bin image by @crazy-max in #13568
• ci: fix bin-image job by @crazy-max in #13569
• pkg/compose: defaultNetworkSettings: refactor by @thaJeztah in #13580
• pkg/compose: un-export consts by @thaJeztah in #13584
• modernize some code by @thaJeztah in #13588

⚙️ Dependencies

• update to go1.25.7 by @thaJeztah in #13573
• build(deps): bump golang.org/x/sys from 0.40.0 to 0.41.0 by @dependabot[bot] in #13578
• build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.3 to 4.0.0-rc.4 by @dependabot[bot] in #13541
• migrate to moby modules by @thaJeztah in #13078

New Contributors

• @MaheshThakur9152 made their first contribution in #13529
• @salmanmkc made their first contribution in #13546
• @Nepomuk5665 made their first contribution in #13551
• @ibrahimypr made their first contribution in #13549
• @veeceey made their first contribution in #13607

Full Changelog: v5.0.2...v5.1.0

What's Changed

🐛 Fixes

• Fixed progress UI to adapt to terminal width by @ndeloof in #13519
• Removed warning when no explicit build has been requested. by @ndeloof in #13493
• Restored runtime_flags support in models by @ilopezluna in #13460
• Added service name completion to down command by @bmo-at in #13470
• Fixed tilde in --env-file paths expanded to user home directory by @tensorworkerr in #13510
• Handle healthcheck.disable: true by @stavros-k in #13494
• Fixed shutdown and error handling for large file change batches in watch by @amyssnippet in #13525

🔧 Internal

• Added unit test for upOptions.OnExit method by @htoyoda18 in #13489
• clean up temporary compose files after conversion by @htoyoda18 in #13483
• Fixed typo in isSwarmEnabled method name by @htoyoda18 in #13481
• Fixed incorrect usage of errgroup.WithContext by @htoyoda18 in #13480
• Fixed timeout initialization when waitTimeout is zero by @htoyoda18 in #13471
• Extracted API version constants to dedicated file by @htoyoda18 in #13503
• Replace tabbed indentation in sdk.md by @pkqk in #13505
• Improved attach error handling and cleanup by @htoyoda18 in #13488
• Modernize tests by @dgageot in #13531
• set fsnotify build tag when building for OSX by @ndeloof in #13532

⚙️ Dependencies

• build(deps): bump github.com/klauspost/compress to v1.18.2 by @thaJeztah in #13499
• go.mod: remove exclude rules by @thaJeztah in #13498
• build(deps): bump github.com/containerd/containerd/v2 to v2.2.1 by @thaJeztah in #13497
• build(deps): bump golang.org/x/sys from 0.39.0 to 0.40.0 by @dependabot[bot] in #13502
• build(deps): bump google.golang.org/grpc from 1.77.0 to 1.78.0 by @dependabot[bot] in #13475
• build(deps): bump github.com/go-viper/mapstructure/v2 from 2.4.0 to 2.5.0 by @dependabot[bot] in #13506
• build(deps): bump github.com/sirupsen/logrus v1.9.4 by @thaJeztah in #13518
• Bump compose to v2.10.1 by @ndeloof in #13528

New Contributors

• @bmo-at made their first contribution in #13470
• @pkqk made their first contribution in #13505
• @tensorworkerr made their first contribution in #13510
• @stavros-k made their first contribution in #13494
• @amyssnippet made their first contribution in #13525
• @dgageot made their first contribution in #13531

Full Changelog: v5.0.1...v5.0.2

What's Changed

🐛 Fixes

• Restored support for COMPOSE_COMPATIBILITY by @ndeloof in #13424
• Fixed grammatical errors and improve clarity in code. by @xiaolinny in #13429
• Fixed broken run --quiet. by @ndeloof in #13430
• Fixed SDK example by @ndeloof in #13416
• Added a check buildx version is set before comparing it. by @yangfeiyu20102011 in #13415
• Fixed grammar: pluralize 'service' and remove apostrophes in lets. by @rashmivagha in #13423
• Fixed progress UI not restoring terminal once operation completes. by @ndeloof in #13439
• Fixed status alignment in progress UI. by @ndeloof in #13438
• Restored image layer download progress details on pull. by @ndeloof in #13445
• Added 'configured' event at the end of model configuration phase. by @glours in #13446
• Introduced a build tag to select watcher implementation. by @ndeloof in #13452
• Removed mention for v2 on README. by @alexislefebvre in #13451
• Fixed missing error handling in setEnvWithDotEnv. by @htoyoda18 in #13450
• Adopted morikuni/aec library over raw ANSI sequences. by @ndeloof in #13440
• Prevented incorrect progress metrics to break compose display. by @ndeloof in #13457
• Restored support for BUILDKIT_PROGRESS. by @ndeloof in #13455
• Added check model plugin is successfully loaded. by @ndeloof in #13464
• Added a warning when no service has been selected to build. by @ndeloof in #13467

⚙️ Dependencies

• Drop Go min patch version by @austinvazquez in #13418
• bump golang 1.24.11 by @austinvazquez in #13417
• bump osxcross by @ndeloof in #13425
• bump golang.org/x/sys from 0.38.0 to 0.39.0 by @dependabot[bot] in #13433
• bump github.com/docker/cli-docs-tool from 0.10.0 to 0.11.0 by @dependabot[bot] in #13437
• bump golang.org/x/sync from 0.18.0 to 0.19.0 by @dependabot[bot] in #13434
• bump tags.cncf.io/container-device-interface from 1.0.1 to 1.1.0 by @dependabot[bot] in #13441
• bump github.com/moby/buildkit from 0.26.2 to 0.26.3 by @dependabot[bot] in #13462

New Contributors

• @yangfeiyu20102011 made their first contribution in #13415
• @xiaolinny made their first contribution in #13429
• @alexislefebvre made their first contribution in #13451
• @htoyoda18 made their first contribution in #13450

Full Changelog: v5.0.0...v5.0.1

Major changes in this release:

• Compose can now officially be used as a SDK to be integrated into third-party softwares
• Internal builder has been removed, build is delegated to Docker Bake (same as docker build command)

Why "v5" ?

We decided to skip 3.0.0 for next major release after docker Compose v2 to prevent (more) confusion with the obsolete docker-compose file versions 2.x and 3.x inherited from Docker Compose v1. We also skipped 4.0.0 to have a clear separation with this legacy.

What's Changed

✨ Improvements

• drop support for internal buildkit builder by @ndeloof in #13056
• Setup Compose service using functional parameters by @ndeloof in #13312
• Introduce abstractions to support SDK usage without requiring Docker CLI by @glours in #13313
• configure Compose service with io.Reader and io.Writer by @glours in #13322
• Make progress Writer a CLI component by @ndeloof in #13316
• SDK docs by @ndeloof in #13350
• document support for OCI and Git remote resources by @ndeloof in #13362
• run hooks on restart by @ndeloof in #13321
• fix(run): Ensure images exist only for the target service in run command by @idsulik in #13325
• Add load project to api definition by @glours in #13329
• introduce --insecure-registry, reserved for testing purpose by @ndeloof in #13355
• Move progress package to cmd as a command line component by @ndeloof in #13357
• Added support for build.no_cache_filter by @ndeloof in #13377
• add --wait option to start command by @ndeloof in #13409

🐛 Fixes

• fix OCI compose override support by @ndeloof in #13311
• Fix help output for "exec --no-tty" option by @tonyo in #13314
• fix typo in error message by @stasadev in #13328
• disable progress UI when build is ran with --print by @ndeloof in #13351
• add (restore) support for detach keys by @ndeloof in #13369
• images command should display image Created time or N/A if not available by @ndeloof in #13376
• Fix support for port range by @ndeloof in #13381
• skip includes preparing publish by @ndeloof in #13400
• feat(model): ignore runtime flags in model configuration by @ilopezluna in #13404

🔧 Internal

• Next release will be major version v5.x by @ndeloof in #13375
• Test to check writeComposeFile detects invalid OCI artifact by @ndeloof in #13309
• Code Cleanup by @ndeloof in #13315
• fix various linting issues by @thaJeztah in #13326
• Making the American/British spellings consistent to the error messages by @JLesDev in #13366
• gha: test against docker v29, v28, and rename checks to use stable, oldstable by @thaJeztah in #13380
• refactor: replace Split in loops with more efficient SplitSeq by @vicerace in #13393
• refactor: use strings.Builder to improve performance by @liuyueyangxmu in #13398
• Fix grammar: change 'adopted' to 'adopt' in Docker Swarm note by @rashmivagha in #13407
• golangci-lint: use gci formatter instead of goimports by @thaJeztah in #13406
• refactor: replace interface{} with any for clarity and modernization by @zjumathcode in #13411

⚙️ Dependencies

• Bump compose go to v2.10.0 by @ndeloof in #13410
• build(deps): bump github.com/containerd/platforms from 1.0.0-rc.1 to 1.0.0-rc.2 by @dependabot[bot] in #13353
• build(deps): bump github.com/docker/docker from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in #13361
• build(deps): bump github.com/containerd/containerd/v2 from 2.1.4 to 2.2.0 by @dependabot[bot] in #13358
• build(deps): bump github.com/docker/cli from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in #13360
• build(deps): bump golang.org/x/sys from 0.37.0 to 0.38.0 by @dependabot[bot] in #13367
• build(deps): bump golang.org/x/sync from 0.17.0 to 0.18.0 by @dependabot[bot] in #13368
• Dockerfile: update golangci-lint to v2.6.2 by @thaJeztah in #13370
• build(deps): bump buildx v0.30.0, buildkit v0.26.0, otel v1.38.0, otel/contrib v0.63.0 by @thaJeztah in #13379
• bump dependencies by @ndeloof in #13392
• build(deps): bump github.com/hashicorp/go-version from 1.7.0 to 1.8.0 by @dependabot[bot] in #13403
• build(deps): bump golang.org/x/crypto v0.45.0 by @thaJeztah in #13405

New Contributors

• @tonyo made their first contribution in #13314
• @stasadev made their first contribution in #13328
• @JLesDev made their first contribution in #13366
• @vicerace made their first contribution in #13393
• @liuyueyangxmu made their first contribution in #13398
• @ilopezluna made their first contribution in #13404
• @rashmivagha made their first contribution in #13407
• @zjumathcode made their first contribution in #13411

Full Changelog: v2.40.2...v5.0.0

What's Changed

This is the first (candidate) release for next major Docker Compose release.
To avoid confusion with the "v2" and "v3" legacy compose file formats, we decided to directly jump to version 5.x

Major changes in this release:

• Compose can now officially be used as a SDK to be integrated into third-party softwares
• Internal builder has been removed, build is delegated to Docker Bake (same as docker build command)

✨ Improvements

• Document use as a SDK by @ndeloof in #13350
• Setup Compose service using functional parameters by @ndeloof in #13312
• drop support for internal buildkit builder by @ndeloof in #13056
• document support for OCI and Git remote resources by @ndeloof in #13362
• introduce --insecure-registry, reserved for testing purpose by @ndeloof in #13355
• add (restore) support for detach keys by @ndeloof in #13369

🐛 Fixes

• fix(run): Ensure images exist only for the target service in run command by @idsulik in * fix typo in error message by @stasadev in #13328
  #13325

🔧 Internal

• fix various linting issues by @thaJeztah in #13326

⚙️ Dependencies

• bump compose-go to version v2.9.1 by @glours in #13332
• build(deps): bump github.com/containerd/platforms from 1.0.0-rc.1 to 1.0.0-rc.2 by @dependabot[bot] in #13353
• build(deps): bump github.com/moby/buildkit from 0.25.1 to 0.25.2 by @dependabot[bot] in #13359
• build(deps): bump github.com/docker/docker from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in #13361
• build(deps): bump github.com/containerd/containerd/v2 from 2.1.4 to 2.2.0 by @dependabot[bot] in #13358
• build(deps): bump github.com/docker/cli from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in #13360
• build(deps): bump golang.org/x/sys from 0.37.0 to 0.38.0 by @dependabot[bot] in #13367
• build(deps): bump golang.org/x/sync from 0.17.0 to 0.18.0 by @dependabot[bot] in #13368

New Contributors

• @tonyo made their first contribution in #13314
• @stasadev made their first contribution in #13328
• @JLesDev made their first contribution in #13366

Full Changelog: v2.40.2...v5.0.0-rc.1

What's Changed

🐛 Fixes

• Compose can't create a tar with adequate uid:gid ownership by @ndeloof in #13299
• Test digest or canonical reference, not only tag, when checking if an image is already present by @glours in #13302

🔧 Internal

• Fail build if minimal required version of buildx isn't installed by @ndeloof in #13295
• remove unused code to only rely on api.Service by @ndeloof in #13300
• Introduce WithPrompt to configure compose backend to use a plugable UI component for user interaction by @ndeloof in #13308

Full Changelog: v2.40.1...v2.40.2

What's Changed

🐛 Fixes

• Write error to watcher error channel if Start() fails by @Trolldemorted in #13263
• Fix: set PWD only if not set by @kianelbo in #13268
• bake only interpolates ${*} by @ndeloof in #13270
• Fix: make "publish" push all compose files addressed in "extends" statements when using "profiles". by @ogoulpeau-ledger in #13277
• Support Ctrl+Z to run compose in background by @ndeloof in #13289
• Fix race-condition bug in publish command by @paul-kinexon in #13291
• Set secret/config uid:gid to match container's USER by @ndeloof in #13288
• Fix failure to delegate build with bake by @ndeloof in #13275
• Make CTRL+Z a no-op operation on Windows by @glours in #13293

🔧 Internal

• pkg/compose: align classic builder implementation with docker/cli by @thaJeztah in #13278
• pkg/compose: build with bake: drop support for buildx v0.16 and lower by @thaJeztah in #13280
• Use fixed version of compose bridge transformer images by @glours in #13284

⚙️ Dependencies

• Build(deps): bump github.com/docker/docker from 28.5.0+incompatible to 28.5.1+incompatible by @dependabot[bot] in #13274
• Build(deps): bump github.com/docker/cli from 28.5.0+incompatible to 28.5.1+incompatible by @dependabot[bot] in #13273
• Build(deps): bump golang.org/x/sys from 0.36.0 to 0.37.0 by @dependabot[bot] in #13272
• Build(deps): bump docker/buildx v0.29.1, moby/buildkit v0.25.1 by @thaJeztah in #13279
• Bump golang to version 1.24.9 by @glours in #13285

New Contributors

• @Trolldemorted made their first contribution in #13263
• @ogoulpeau-ledger made their first contribution in #13277
• @paul-kinexon made their first contribution in #13291

Full Changelog: v2.40.0...v2.40.1

What's Changed

✨ Improvements

• publish Compose application as compose.yaml + images by @ndeloof in #13257

🐛 Fixes

• resolve secrets based on env var before executing bake by @ndeloof in #13237
• pass bake secrets by env by @ndeloof in #13249
• escape $ in bake.json as interpolation already has been managed by cpmpose by @ndeloof in #13259

🔧 Internal

• pkg/compose: remove uses of deprecated mitchellh/mapstructure module by @thaJeztah in #13239
• pkg/watch: remove unused IsWindowsShortReadError by @thaJeztah in #13052
• pkg/compose: build: remove permissions warning on Windows by @thaJeztah in #13236
• pluginMain: remove uses of DockerCLI.Apply by @thaJeztah in #13240
• use containerd registry client by @ndeloof in #13245
• provider services: use '--project-name=' notation by @glours in #13250
• gha: update test-matrix: remove docker 26.x by @thaJeztah in #13254
• pkg/compose: explicitly map AuthConfig fields instead of a direct cast by @thaJeztah in #13253
• cmd/compose: fix minor linting issues by @thaJeztah in #13252
• use containerd client for OCI operations by @ndeloof in #13251

⚙️ Dependencies

• build(deps): bump github.com/docker/docker, docker/cli v28.5.0-rc.1 by @thaJeztah in #13241
• build(deps): bump github.com/docker/docker from 28.5.0-rc.1+incompatible to 28.5.0+incompatible by @dependabot[bot] in #13260
• build(deps): bump github.com/docker/cli from 28.5.0-rc.1+incompatible to 28.5.0+incompatible by @dependabot[bot] in #13261

Full Changelog: v2.39.4...v2.40.0