70:T1c19,![mont blanc](https://cdn.trylle.com/media/images/cb9d8667a2b40c77c043dd3f97c1c3dd?key=ATrSto%2B8lwU%2FdQSS7xqzlc8ojT9N%2BEasdUv24Obh%2Bb7kajUS9zd0y%2Bg%2Bj6PFwscTvxpueiXnDlbrXJ0NDet4EHX9Cl76A2ncfx7SR%2BoFpOHGgelSMuZdmADm96zHA9epGljuzB2Ju9okmTGk2PUF%2BAIZFONOMjlS9VGjPGHaewhzpWub5mWwpLxZNFf3GJRrZJMeFjRFX%2FRb5B5LlxGhoWT3j3YQkA%3D%3D) 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 * Setup Compose service using functional parameters by @ndeloof in * Introduce abstractions to support SDK usage without requiring Docker CLI by @glours in * configure Compose service with io.Reader and io.Writer by @glours in * Make progress Writer a CLI component by @ndeloof in * SDK docs by @ndeloof in * document support for OCI and Git remote resources by @ndeloof in * run hooks on restart by @ndeloof in * fix(run): Ensure images exist only for the target service in run command by @idsulik in * Add load project to api definition by @glours in * introduce \-\-insecure\-registry, reserved for testing purpose by @ndeloof in * Move progress package to cmd as a command line component by @ndeloof in * Added support for `build.no_cache_filter` by @ndeloof in * add \-\-wait option to start command by @ndeloof in ### 🐛 Fixes * fix OCI compose override support by @ndeloof in * Fix help output for "exec \-\-no\-tty" option by @tonyo in * fix typo in error message by @stasadev in * disable progress UI when build is ran with \-\-print by @ndeloof in * add (restore) support for detach keys by @ndeloof in * images command should display image Created time or N/A if not available by @ndeloof in * Fix support for port range by @ndeloof in * skip includes preparing publish by @ndeloof in * feat(model): ignore runtime flags in model configuration by @ilopezluna in ### 🔧 Internal * Next release will be major version v5.x by @ndeloof in * Test to check writeComposeFile detects invalid OCI artifact by @ndeloof in * Code Cleanup by @ndeloof in * fix various linting issues by @thaJeztah in * Making the American/British spellings consistent to the error messages by @JLesDev in * gha: test against docker v29, v28, and rename checks to use `stable`, `oldstable` by @thaJeztah in * refactor: replace Split in loops with more efficient SplitSeq by @vicerace in * refactor: use strings.Builder to improve performance by @liuyueyangxmu in * Fix grammar: change 'adopted' to 'adopt' in Docker Swarm note by @rashmivagha in * golangci\-lint: use gci formatter instead of goimports by @thaJeztah in * refactor: replace interface{} with any for clarity and modernization by @zjumathcode in ### ⚙️ Dependencies * Bump compose go to v2.10.0 by @ndeloof in * build(deps): bump github.com/containerd/platforms from 1.0.0\-rc.1 to 1.0.0\-rc.2 by @dependabot[bot] in * build(deps): bump github.com/docker/docker from 28.5.1\+incompatible to 28.5.2\+incompatible by @dependabot[bot] in * build(deps): bump github.com/containerd/containerd/v2 from 2.1.4 to 2.2.0 by @dependabot[bot] in * build(deps): bump github.com/docker/cli from 28.5.1\+incompatible to 28.5.2\+incompatible by @dependabot[bot] in * build(deps): bump golang.org/x/sys from 0.37.0 to 0.38.0 by @dependabot[bot] in * build(deps): bump golang.org/x/sync from 0.17.0 to 0.18.0 by @dependabot[bot] in * Dockerfile: update golangci\-lint to v2.6.2 by @thaJeztah in * build(deps): bump buildx v0.30.0, buildkit v0.26.0, otel v1.38.0, otel/contrib v0.63.0 by @thaJeztah in * bump dependencies by @ndeloof in * build(deps): bump github.com/hashicorp/go\-version from 1.7.0 to 1.8.0 by @dependabot[bot] in * build(deps): bump golang.org/x/crypto v0.45.0 by @thaJeztah in ## New Contributors * @tonyo made their first contribution in * @stasadev made their first contribution in * @JLesDev made their first contribution in * @vicerace made their first contribution in * @liuyueyangxmu made their first contribution in * @ilopezluna made their first contribution in * @rashmivagha made their first contribution in * @zjumathcode made their first contribution in **Full Changelog**: 55:["$","$L6c",null,{"entries":[{"key":["platform",{"userId":"anon"},"repo","releases",{"owner":"docker","repo":"compose"},"detail","v5.0.0"],"data":{"id":"215927","version":"v5.0.0","channel":"stable","title":"v5.0.0 \"Mont Blanc\"","publishedAt":"2025-12-02T07:41:49Z","summary":"![mont blanc](https://cdn.trylle.com/media/images/cb9d8667a2b40c77c043dd3f97c1c3dd?key=ATrSto%2B8lwU%2FdQSS7xqzlc8ojT9N%2BEasdUv24Obh%2Bb7kajUS9zd0y%2Bg%2Bj6PFwscTvxpueiXnDlbrXJ0NDet4EHX9Cl76A2ncfx7SR%2BoFpOHGgelSMuZdmADm96zHA9epGljuzB2Ju9okmTGk2PUF%2BAIZFONOMjlS9VGjPGHaewhzpWub5mWwpLxZNFf3GJRrZJMeFjRFX%2FRb5B5LlxGhoWT3j3YQkA%3D%3D)\n","notesMarkdown":"$70","attachments":[{"id":"80808","name":"checksums.txt","size":3420,"sizeLabel":"3.3 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/checksums.txt"},{"id":"80809","name":"docker-compose-darwin-aarch64","size":30183858,"sizeLabel":"28.8 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-aarch64"},{"id":"80810","name":"docker-compose-darwin-aarch64.provenance.json","size":50142,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-aarch64.provenance.json"},{"id":"80811","name":"docker-compose-darwin-aarch64.sbom.json","size":280078,"sizeLabel":"274 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-aarch64.sbom.json"},{"id":"80812","name":"docker-compose-darwin-aarch64.sha256","size":96,"sizeLabel":"96 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-aarch64.sha256"},{"id":"80813","name":"docker-compose-darwin-x86_64","size":31653184,"sizeLabel":"30.2 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-x86_64"},{"id":"80814","name":"docker-compose-darwin-x86_64.provenance.json","size":50141,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-x86_64.provenance.json"},{"id":"80815","name":"docker-compose-darwin-x86_64.sbom.json","size":280077,"sizeLabel":"274 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-x86_64.sbom.json"},{"id":"80816","name":"docker-compose-darwin-x86_64.sha256","size":95,"sizeLabel":"95 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-darwin-x86_64.sha256"},{"id":"80817","name":"docker-compose-linux-aarch64","size":29939597,"sizeLabel":"28.6 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-aarch64"},{"id":"80818","name":"docker-compose-linux-aarch64.provenance.json","size":50137,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-aarch64.provenance.json"},{"id":"80819","name":"docker-compose-linux-aarch64.sbom.json","size":282025,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-aarch64.sbom.json"},{"id":"80820","name":"docker-compose-linux-aarch64.sha256","size":95,"sizeLabel":"95 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-aarch64.sha256"},{"id":"80821","name":"docker-compose-linux-armv6","size":29468784,"sizeLabel":"28.1 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv6"},{"id":"80822","name":"docker-compose-linux-armv6.provenance.json","size":50163,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv6.provenance.json"},{"id":"80823","name":"docker-compose-linux-armv6.sbom.json","size":282023,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv6.sbom.json"},{"id":"80824","name":"docker-compose-linux-armv6.sha256","size":93,"sizeLabel":"93 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv6.sha256"},{"id":"80825","name":"docker-compose-linux-armv7","size":29467632,"sizeLabel":"28.1 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv7"},{"id":"80826","name":"docker-compose-linux-armv7.provenance.json","size":50162,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv7.provenance.json"},{"id":"80827","name":"docker-compose-linux-armv7.sbom.json","size":282023,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv7.sbom.json"},{"id":"80828","name":"docker-compose-linux-armv7.sha256","size":93,"sizeLabel":"93 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-armv7.sha256"},{"id":"80829","name":"docker-compose-linux-ppc64le","size":30964743,"sizeLabel":"29.5 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-ppc64le"},{"id":"80830","name":"docker-compose-linux-ppc64le.provenance.json","size":50140,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-ppc64le.provenance.json"},{"id":"80831","name":"docker-compose-linux-ppc64le.sbom.json","size":282025,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-ppc64le.sbom.json"},{"id":"80832","name":"docker-compose-linux-ppc64le.sha256","size":95,"sizeLabel":"95 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-ppc64le.sha256"},{"id":"80833","name":"docker-compose-linux-riscv64","size":30158706,"sizeLabel":"28.8 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-riscv64"},{"id":"80834","name":"docker-compose-linux-riscv64.provenance.json","size":50140,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-riscv64.provenance.json"},{"id":"80835","name":"docker-compose-linux-riscv64.sbom.json","size":282025,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-riscv64.sbom.json"},{"id":"80836","name":"docker-compose-linux-riscv64.sha256","size":95,"sizeLabel":"95 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-riscv64.sha256"},{"id":"80837","name":"docker-compose-linux-s390x","size":32939878,"sizeLabel":"31.4 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-s390x"},{"id":"80838","name":"docker-compose-linux-s390x.provenance.json","size":50130,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-s390x.provenance.json"},{"id":"80839","name":"docker-compose-linux-s390x.sbom.json","size":282023,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-s390x.sbom.json"},{"id":"80840","name":"docker-compose-linux-s390x.sha256","size":93,"sizeLabel":"93 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-s390x.sha256"},{"id":"80841","name":"docker-compose-linux-x86_64","size":31284792,"sizeLabel":"29.8 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-x86_64"},{"id":"80842","name":"docker-compose-linux-x86_64.provenance.json","size":50136,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-x86_64.provenance.json"},{"id":"80843","name":"docker-compose-linux-x86_64.sbom.json","size":282024,"sizeLabel":"275 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-x86_64.sbom.json"},{"id":"80844","name":"docker-compose-linux-x86_64.sha256","size":94,"sizeLabel":"94 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-linux-x86_64.sha256"},{"id":"80845","name":"docker-compose-windows-aarch64.exe","size":30168064,"sizeLabel":"28.8 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-aarch64.exe"},{"id":"80846","name":"docker-compose-windows-aarch64.exe.sha256","size":101,"sizeLabel":"101 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-aarch64.exe.sha256"},{"id":"80847","name":"docker-compose-windows-aarch64.provenance.json","size":50164,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-aarch64.provenance.json"},{"id":"80848","name":"docker-compose-windows-aarch64.sbom.json","size":290053,"sizeLabel":"283 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-aarch64.sbom.json"},{"id":"80849","name":"docker-compose-windows-x86_64.exe","size":31980032,"sizeLabel":"30.5 MiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-x86_64.exe"},{"id":"80850","name":"docker-compose-windows-x86_64.exe.sha256","size":100,"sizeLabel":"100 B","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-x86_64.exe.sha256"},{"id":"80851","name":"docker-compose-windows-x86_64.provenance.json","size":50163,"sizeLabel":"49.0 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-x86_64.provenance.json"},{"id":"80852","name":"docker-compose-windows-x86_64.sbom.json","size":290052,"sizeLabel":"283 KiB","contentType":"attachment","downloadUrl":"https://trylle.com/docker/compose/releases/download/v5.0.0/docker-compose-windows-x86_64.sbom.json"}],"htmlUrl":"https://trylle.com/docker/compose/releases/tag/v5.0.0","target":"main","commitSha":"13d70b1c11342dafb534f3793078666437e6d00a","publisher":{"id":-1,"login":"Ghost"},"zipballUrl":"/v1/repositories/docker/compose/archive?ref=v5.0.0&format=zip","tarballUrl":"/v1/repositories/docker/compose/archive?ref=v5.0.0&format=tar.gz","isDraft":false,"isPrerelease":false},"fetchedAt":1793417506547}],"children":"$L71"}]