Docker Compose

No entries match these filters. Clear filters

1. v5.7.0 Nov 2, 2026 · issue 129

   Docker Compose adds --ignore-missing to push, --all-projects and --aggregate to stats, and umask service attribute support⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.7.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.7.0

   └──▷ TRY IT
   Push all service images, silently skipping any that are not present in the local image store.
   copy

   $ docker compose push --ignore-missing

   Watch live resource usage rolled up across every running Compose project on the host.
   copy

   $ docker compose stats --all-projects --aggregate

   Set a restrictive file-creation mask for a service so new files inside the container are not world-readable.
   compose.yaml copy

   services:
     api:
       image: myapp:latest
       umask: '0027'

   • Skip images not available locally during push with the new --ignore-missing flag on docker compose push.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Monitor resource usage across all running Compose projects at once with the new --all-projects flag on docker compose stats, and roll up per-service totals with --aggregate.
   • Set a service's umask attribute in compose.yaml to control the file-creation mask inside the container.
   • Reuse existing dependency containers without recreating them by passing --no-recreate to docker compose run.
   • Pass the --parallel concurrency limit through to BuildKitBuildKitA build engine for Docker images, maintained by Moby, that replaces the legacy Docker builder with parallel layer execution, cache mounts, and secret handling — giving cyber tools faster, more reproducible container builds. bake as --jobs when building with bake.

   +4 more show less

   • Let a service opt out of its own name as a network alias in compose.yaml.
   • Docker Compose now uses the Docker Desktop Hub session for Docker Hub registry credentials automatically.
   • Adds new library API capabilities: PushOptions.IgnoreMissing lets callers skip locally absent images when calling api.Compose.Push, and UpOptions.Validate() lets callers validate Up option combinations upfront, returning *api.IncompatibleOptionsError (matchable with errors.Is(err, api.ErrIncompatibleOptions)) instead of silently ignoring them.
   • api.Compose is now assembled from six smaller focused interfaces with the same method set, making it easier to implement or wrap in library code.
   • Skip images not available locally during push with the new --ignore-missing flag on docker compose push.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Monitor resource usage across all running Compose projects at once with the new --all-projects flag on docker compose stats, and roll up per-service totals with --aggregate.
   • Set a service's umask attribute in compose.yaml to control the file-creation mask inside the container.
   • Adds new library API capabilities: PushOptions.IgnoreMissing lets callers skip locally absent images when calling api.Compose.Push, and UpOptions.Validate() lets callers validate Up option combinations upfront, returning *api.IncompatibleOptionsError (matchable with errors.Is(err, api.ErrIncompatibleOptions)) instead of silently ignoring them.

   5 more in Everything

   └──▷ BREAKING ON UPGRADE

   • !DownOptions.Images is now typed as api.ImagePruneMode; a string variable passed where it was previously accepted now requires an explicit conversion.
   • !compose.ServiceHash, compose.NetworkHash, and compose.VolumeHash are no longer exported; code that referenced them must switch to the internal package or remove the call.
   • !The interactive up keyboard menu is no longer built by the library; callers must set NavigationMenu: true AND supply an implementation via compose.WithNavigationMenu(...), or no menu is displayed.
   • !Up now ignores StartOptions.Project and operates only on the project passed directly to it; callers relying on StartOptions.Project must pass the project directly.
2. v5.6.0 Oct 2, 2026 · issue 093

   Docker Compose v5.6.0 adds partial jobs support, richer provider-service networking, and a more forgiving docker compose port command.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.6.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.6.0

   • Makes PRIVATE_PORT optional for docker compose port, so the command works without specifying an internal port.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Adds partial support for jobs via compose-go jobs and container-spec layering; manually-triggered jobs are supported now, scheduled jobs are not yet available.
   • Adds get-service-config provider request so providers can retrieve their resolved service configuration.
   • Adds publish-endpoint capability that deploys a network relay for provider services.
   • Adds get-relay-info so providers know where to bind for the relay.

   +3 more show less

   • Adds a dedicated network for the provider relay link, isolating relay traffic from application networks.
   • Includes provider services in the image phase, with image distribution on demand.
   • Warns on unsupported Compose-file attributes so unknown keys are surfaced rather than silently ignored.
   • Makes PRIVATE_PORT optional for docker compose port, so the command works without specifying an internal port.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Adds partial support for jobs via compose-go jobs and container-spec layering; manually-triggered jobs are supported now, scheduled jobs are not yet available.
   • Adds get-service-config provider request so providers can retrieve their resolved service configuration.
   • Adds publish-endpoint capability that deploys a network relay for provider services.
   • Adds get-relay-info so providers know where to bind for the relay.

   +2 more show less

   • Adds a dedicated network for the provider relay link, isolating relay traffic from application networks.
   • Warns on unsupported Compose-file attributes so unknown keys are surfaced rather than silently ignored.

   1 more in Everything

3. v5.5.1 Sep 3, 2026 · issue 064

   Docker Compose v5.5.1 surfaces lifecycle hook output and exposes OpenTelemetryOpenTelemetryAn open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. shutdown errors via --debug

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.5.1 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.5.1

   • Surfaces OpenTelemetry shutdown errors when running with --debug, making tracing misconfiguration visible instead of silently swallowed.
   • Captures and surfaces lifecycle hook output (stdout/stderr) directly in Compose output, so pre/post hook activity is visible without digging into container logs.

   2 details in Everything

4. docs update Aug 25, 2026 · issue 056

   Docker Compose watch now supports --prune=false to retain superseded images after rebuilds.

   └──▷ TRY IT
   Preserve superseded image layers during iterative development to allow quick rollback or inspection without re-pulling.
   copy

   $ docker compose watch --prune=false

5. v5.5.0 Aug 17, 2026 · issue 049

   Docker Compose v5.5.0 overhauIs image digest reconciliation and makes compose pull honor pull_policy refresh windows.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.5.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.5.0

   └──▷ USE IT
   Use a weekly pull policy so compose pull skips re-pulling images that were already pulled within the last 7 days.
   compose.yaml copy

   services:
     web:
       image: myapp:latest
       pull_policy: weekly

   • New image digest reconciliation logic in compose up prevents unnecessary container recreation by re-evaluating digests more accurately.
   • compose pull now honors pull_policy refresh windows (daily, weekly, every_N), skipping redundant pulls within the configured window.

   2 details in Everything

   └──▷ BREAKING ON UPGRADE

   • !Existing containers may be recreated the first time you run compose up after upgrading to v5.5.0, as image digests are re-evaluated using the new reconciliation logic.
6. v5.4.0 Aug 3, 2026 · issue 035

   Docker Compose v5.4.0 introduces a new reconciliation model for volumes and networks lifecycle management.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.4.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.4.0

   • Adds volume recreation modelling to the reconciliation plan, giving Compose finer control over when volumes are recreated during up.
   • Adds network lifecycle modelling to the reconciliation plan, enabling Compose to track network create/remove operations as first-class steps in the deployment plan.

   2 details in Everything

7. v5.3.0 Jul 2, 2026 · issue 012

   Docker Compose v5.3.0 adds native support for pre-start init containers.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.3.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.3.0

   └──▷ USE IT
   Run a setup task (e.g., DB migration) in an init container that must succeed before your app service starts.
   yaml copy

   services:
     app:
       image: myapp:latest
       depends_on:
         init-migrate:
           condition: service_completed_successfully
     init-migrate:
       image: myapp:latest
       command: ["python", "manage.py", "migrate"]
       x-init: true

   • Supports pre-start init containers, allowing services to declare initialization containers that run and complete before the main service starts.

   1 detail in Everything

8. v5.2.0 Jun 23, 2026 · release notes

   Docker Compose v5.2.0 introduces a new reconciliation algorithm and a rawsetenv message type for provider plugins.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.2.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.2.0

   • New reconciliation algorithm computes a smarter plan between observed and expected state when converging Compose workloads.
   • Adds rawsetenv message type for provider plugins, enabling plugins to set environment variables without interpolation.

   2 details in Everything

9. v5.2.0 Jun 23, 2026 · issue 012

   Docker Compose v5.2.0 introduces a new reconciliation algorithm and a rawsetenv message type for provider plugins.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v5.2.0 https://github.com/docker/compose.git
   # already have the repo? check out this version:
   $ git checkout v5.2.0

   • New reconciliation algorithm aligns observed state with expected state more accurately during docker compose up and related operations.
   • Adds rawsetenv message type for provider plugins, enabling plugins to set environment variables without shell interpolation.

   2 details in Everything

10. v5.1.4 May 20, 2026 · release notes

    Docker Compose v5.1.4 adds a stop lifecycle hook for external providers.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v5.1.4 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v5.1.4

11. v5.0.2 Jan 21, 2026 · release notes

    Docker Compose v5.0.2 adds down service name completion and proper handling for healthcheck.disable

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v5.0.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v5.0.2

    • Handle healthcheck.disable: true in compose files

    1 detail in Everything

12. v5.0.0 Dec 2, 2025 · release notes

    Docker Compose v5 ships an official Go SDK, delegates builds to Docker Bake, and adds --wait to start plus new build options.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v5.0.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v5.0.0

    └──▷ USE IT
    Skip the cache for a specific build stage (e.g., a frequently-changing deps stage) without disabling cache for the entire build.
    yaml copy

    # compose.yaml snippet
    services:
      app:
        build:
          context: .
          no_cache_filter:
            - deps

    • Officially supports use as a Go SDK for embeddingembeddingLists of numbers a model produces to represent the meaning of text, images or code, so similar items sit close together. They power semantic search and RAG. Compose into third-party software without requiring Docker CLI.
    • Delegates all image building to Docker Bake (internal BuildKitBuildKitA build engine for Docker images, maintained by Moby, that replaces the legacy Docker builder with parallel layer execution, cache mounts, and secret handling — giving cyber tools faster, more reproducible container builds. builder removed), aligning with docker build behavior.
    • Adds --wait option to the compose start command to block until services are healthy.
    • Adds build.no_cache_filter support in Compose files to selectively skip cache for specific build stages.
    • Introduces --insecure-registry flag (reserved for testing scenarios).

    +2 more show less

    • Runs lifecycle hooks on service restart.
    • Adds LoadProject to the Compose API definition, expanding SDK surface.

    7 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The internal BuildKit builder has been removed; builds are now fully delegated to Docker Bake. Any workflow relying on Compose's internal builder will break on upgrade.
13. advisory CVE-2025-62725 Oct 27, 2025 · issue 128
    • CVE-2025-62725: Path Traversal via OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. Artifact Layer Annotations (affects < v2.40.2)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
14. v2.40.2 Oct 22, 2025 · release notes

    Docker Compose v2.40.2 introduces a plugable UI component for user interactions via the WithPrompt interface.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.40.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.40.2

15. v2.40.1 Oct 17, 2025 · release notes

    Adds bake publish support for profiles and CTRL+Z backgrounding

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.40.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.40.1

    • docker compose bake publish now correctly handles extends statements when using profiles
    • Supports Ctrl+Z to suspend the command and run it in the background

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Drop support for buildx v0.16 and lower when building with bake
16. v2.40.0 Oct 3, 2025 · release notes

    Docker Compose v2.40.0 lets you publish a Compose app as a portable compose.yaml + images bundle.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.40.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.40.0

17. v2.39.4 Sep 19, 2025 · release notes

    Docker Compose v2.39.4 adds develop.watch.initial_sync support for fine-grained file-watch control.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.39.4 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.39.4

    └──▷ USE IT
    Suppress the initial bulk sync when starting a watch session, so only live file changes are propagated — useful when the container already has the correct files baked in.
    yaml copy

    develop:
      watch:
        - path: ./src
          action: sync
          target: /app/src
          initial_sync: false

18. v2.39.3 Sep 9, 2025 · release notes

    Docker Compose v2.39.3 adds shell completions for the --progress flag.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.39.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.39.3

19. v2.39.0 Jul 24, 2025 · release notes

    Docker Compose v2.39.0 adds time-filtered events, FreeBSD support, model config inspection, and build provenanceprovenanceEvidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build./SBOMSBOMA software bill of materials, an inventory of the components and versions inside an application. It helps teams find affected software when a dependency has a vulnerability or licensing issue. attributes.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.39.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.39.0

    └──▷ TRY IT
    Filter container events to a specific time window — useful for post-incident review of what happened during a deployment window.
    copy

    $ docker compose events --since 2025-07-01T10:00:00 --until 2025-07-01T10:30:00

    Inspect only the model-related configuration in a Compose file, e.g. to validate AI model service definitions before deploying.
    copy

    $ docker compose config --models

    • Adds --since and --until flags to the events command for time-bounded event filtering.
    • Adds FreeBSD platform support.
    • Adds --models flag to the config command to inspect model configuration.
    • Introduces provenance and sbom build attributes support for supply-chain metadata.
    • Shows build progress in the terminal during watch rebuilds.

    5 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !COMPOSE_BAKE=false is deprecated and will warn on use; users relying on this flag to disable bake should plan for its removal.
20. v2.38.2 Jul 8, 2025 · release notes

    Docker Compose v2.38.2 adds --networks flag to the config command for filtered network output.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.38.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.38.2

    └──▷ TRY IT
    Inspect only the resolved network definitions in a Compose project — useful for auditing network topology without the noise of services, volumes, and other keys.
    copy

    $ docker compose config --networks

21. v2.38.1 Jun 30, 2025 · release notes

    Docker Compose v2.38.1 adds support for model_variable in Compose files.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.38.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.38.1

    • Supports model_variable for referencing model-provided variables in Compose configurations.

    1 detail in Everything

22. v2.38.0 Jun 30, 2025 · release notes

    Docker Compose v2.38.0 adds model support, a new volumes command, and lifts bind-mount publish restrictions.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.38.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.38.0

    └──▷ TRY IT
    List all volumes associated with the current Compose project to audit persistent storage.
    copy

    $ docker compose volumes

    • Introduces support for AI models as a new service type in Compose projects.
    • Adds a new docker compose volumes command for managing project volumes.
    • Removes the publish limitation on bind mounts, enabling port publishing alongside bind-mounted services.
    • Mounts /var/run/docker.sock automatically for services using --use-api-socket.

    4 details in Everything

23. v2.37.3 Jun 24, 2025 · release notes

    Docker Compose v2.37.3 adds cache_to support when building with Bake.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.37.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.37.3

    • Supports cache_to in Compose build configuration when using Bake as the build backend.

    1 detail in Everything

24. v2.37.2 Jun 20, 2025 · release notes

    Docker Compose v2.37.2 introduces use_api_socket support.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.37.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.37.2

    • Adds use_api_socket option, enabling socket-based API communication for Compose services.

    1 detail in Everything

25. v2.37.1 Jun 12, 2025 · release notes

    Docker Compose v2.37.1 adds extra_hosts support when building with Bake.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.37.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.37.1

26. v2.37.0 Jun 5, 2025 · release notes

    Docker Compose v2.37.0 adds Compose Bridge, bake as default builder, and platform/date details in image listings.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.37.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.37.0

    └──▷ TRY IT
    Opt out of the new bake-based builder if your pipeline depends on the classic per-service build path.
    copy

    $ COMPOSE_BAKE=false docker compose up --build

    • Adds compose bridge subcommand for bridging Compose projects to other environments.
    • Switches to bake as the default image builder, replacing the previous per-service build path (opt out with COMPOSE_BAKE=false).
    • Includes platform and creation date columns when listing images.
    • Adds metadata subcommand support for provider services.

    4 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !bake is now the default image builder; existing setups that rely on the prior per-service build behavior may behave differently — set COMPOSE_BAKE=false to restore the previous behavior.
27. v2.36.1 May 19, 2025 · release notes

    Docker Compose v2.36.1 adds config --lock-image-digests, provider environment support, and array-style provider options.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.36.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.36.1

    └──▷ TRY IT
    Freeze all service image references to exact digests before committing a compose file to production — prevents silent image changes on re-deploy.
    copy

    $ docker compose config --lock-image-digests

    • New config --lock-image-digests flag pins all service images to their current digest in the resolved config output.
    • Provider options now accept an array in addition to a scalar value, enabling richer provider configuration.
    • Providers can now receive environment variables, allowing secrets and runtime config to be passed to provider services.

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The convert alias for the config command has been removed; scripts calling docker compose convert must be updated to use docker compose config.
28. v2.36.0 May 7, 2025 · release notes

    Docker Compose v2.36.0 adds external binary service providers, a build --check flag, network interface naming, and COMPOSE_PROGRESS control.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.36.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.36.0

    └──▷ TRY IT
    Validate your build configuration in CI before committing — catches misconfigured Dockerfiles or build args without running a full build.
    copy

    $ docker compose build --check

    Suppress animated progress output in non-TTY CI environments where spinner/bar rendering produces noisy logs.
    copy

    $ COMPOSE_PROGRESS=plain docker compose up

    Pin a Compose network to a specific host interface name for deterministic routing in multi-NICNICA network interface card or adapter, the hardware that connects a computer to a network. It sends and receives packets over the link. environments.
    yaml copy

    networks:
      mynet:
        driver: bridge
        interface_name: eth-compose0

    • Supports external binaries as service providers, enabling plugins that extend Compose behaviour via service.provider.
    • Adds networks.interface_name to let you specify the host interface name for a Compose-managed network.
    • Adds COMPOSE_PROGRESS environment variable to control progress output style without CLI flags.
    • Introduces docker compose build --check to validate build configuration without executing a build.

    4 details in Everything

29. v2.35.0 Apr 10, 2025 · release notes

    Docker Compose v2.35.0 adds external services for Model Runner, build --print bakefile dump, image-type volumes, and new run quiet flags.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.35.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.35.0

    └──▷ TRY IT
    Inspect the resolved Bake file Compose would use for a build — useful for debugging multi-service build graphs or handing off to docker buildx bake.
    copy

    $ docker compose build --print

    Dump the raw compose config with all env-var placeholders intact (no substitution), handy for auditing or templating pipelines that do their own variable expansion.
    copy

    $ docker compose config --no-env-resolution

    Run a one-off service task without any build or run output cluttering CI logs.
    copy

    $ docker compose run --quiet --quiet-build myservice python manage.py migrate

    • Adds first-class external services support to integrate Docker Model Runner into Compose projects.
    • New config --no-env-resolution flag outputs compose config without interpolating environment variables.
    • New build --print flag dumps the equivalent Bake file for the current build configuration.
    • Adds --quiet and --quiet-build options to the run command to suppress output.
    • Introduces volume.type=image to mount image contents as a volume.

    +1 more show less

    • Sets $PWD environment variable automatically within Compose service contexts.

    6 details in Everything

30. v2.34.0 Mar 14, 2025 · release notes

    Docker Compose v2.34.0 adds refresh pull policy, watch include filters, --env-from-file for run, and a first-class publish command.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.34.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.34.0

    └──▷ TRY IT
    Inject secrets or environment variables from a local file into a one-off task container without baking them into the service definition.
    copy

    $ docker compose run --env-from-file ./secrets.env worker python manage.py migrate

    Limit watch to only rebuild when source files under src/ change, ignoring docs, tests, or other directories.
    yaml copy

    # In docker-compose.yml
    services:
      app:
        develop:
          watch:
            - path: .
              action: rebuild
              include:
                - src/

    Publish a Compose stack as an OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. artifact to a registry for remote reuse.
    copy

    $ docker compose publish registry.example.com/myorg/mystack:latest

    • Supports refresh pull policy, letting services always pull a fresh image even when one is already present locally.
    • Adds include field to watch configuration to filter which files trigger sync/rebuild, reducing noise from unrelated changes.
    • Introduces --env-from-file flag on docker compose run to inject environment variables from a file into one-off containers.
    • Promotes publish to a regular top-level Compose command for publishing Compose stacks as OCI artifacts.

    4 details in Everything

31. v2.33.1 Feb 21, 2025 · release notes

    Docker Compose v2.33.1 adds network gw_priority and enable_ipv4 support (requires Docker v28.0).

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.33.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.33.1

    └──▷ USE IT
    Pin gateway priority and explicitly enable IPv4 on a custom network when running Docker v28.0+.
    yaml copy

    networks:
      mynet:
        driver: bridge
        driver_opts: {}
        ipam:
          config:
            - subnet: 192.168.10.0/24
        enable_ipv4: true
        gw_priority: 10

32. v2.33.0 Feb 12, 2025 · release notes

    Docker Compose v2.33.0 adds opt-in Bake build support, --with-env for publish, and BUILDKIT_PROGRESS control.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.33.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.33.0

    └──▷ TRY IT
    Use Bake as the build backend for all services — useful when you want Bake's advanced build graph and caching features.
    copy

    $ COMPOSE_BAKE=1 docker compose build

    Control build progress output style (e.g. plain logs) when building with Compose, handy in CI pipelines.
    copy

    $ BUILDKIT_PROGRESS=plain docker compose build

    Publish a Compose app and include environment variable values in the published artifact.
    copy

    $ docker compose publish --with-env <image-name>

    • Adds opt-in Bake integration for managing builds: set COMPOSE_BAKE=1 to use Bake as the build backend instead of the internal buildkit client.
    • Supports additional_context referencing another service in the Compose file, enabling cross-service build contexts.
    • Adds BUILDKIT_PROGRESS environment variable support to control build progress output format.
    • Adds --with-env flag to the publish command to include environment variables when publishing.

    4 details in Everything

33. v2.32.2 Jan 7, 2025 · release notes

    Docker Compose v2.32.2 adds --pull flag to the run command for on-demand image pulling.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.32.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.32.2

    └──▷ TRY IT
    Pull the latest image before running a one-off task, ensuring your run command doesn't use a stale local image.
    copy

    $ docker compose run --pull always worker python manage.py migrate

34. v2.32.0 Dec 13, 2024 · release notes

    Docker Compose v2.32.0 adds Bake-based builds and two new Watch actions: restart and sync+exec.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.32.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.32.0

    └──▷ USE IT
    Trigger a container restart on file changes without rebuilding the image — useful for interpreted-language services.
    yaml copy

    # docker-compose.yml
    services:
      app:
        image: myapp
        develop:
          watch:
            - path: ./src
              action: restart

    • Introduces a restart watch action that restarts a container when watched files change, without rebuilding the image.
    • Introduces a sync+exec watch action that syncs files into a running container then executes a command, enabling hot-reload workflows without a full restart.
    • Automatically recreates containers when volume configuration changes, eliminating the need for manual intervention on volume updates.

    3 details in Everything

35. v2.31.0 Nov 28, 2024 · release notes

    Docker Compose v2.31.0 adds a commit command and delegates builds to buildx bake for improved build performance.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.31.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.31.0

    • Adds docker compose commit command to commit container changes to an image.
    • Delegates docker compose build to buildx bake, enabling richer build features and better performance.

    2 details in Everything

36. v2.30.0 Oct 29, 2024 · release notes

    Docker Compose v2.30.0 adds service hooks, a new generate alpha command, export command, CDI device support, and bind-recursive mounts.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.30.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.30.0

    └──▷ TRY IT
    Generate a Compose configuration from an existing setup using the new alpha command.
    copy

    $ docker compose generate

    Reference an OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. Compose artifact directly with the -f flag alongside a local override file.
    copy

    $ docker compose -f oci://registry.example.com/myapp:latest -f compose.override.yml up

    • Introduces service hooks, enabling lifecycle hook actions tied to service events.
    • Adds docker compose generate as an alpha command for generating Compose configuration.
    • Adds docker compose export command to export service container filesystems.
    • Supports CDI (Container Device Interface) device requests via the devices key in Compose files.
    • Supports bind volume option recursive for recursive bind mounts.

    +1 more show less

    • Allows the -f flag to be used with OCI Compose artifacts when specifying Compose files.

    6 details in Everything

37. v2.29.3 Sep 12, 2024 · release notes

    Docker Compose v2.29.3 allows combining bind mounts with rebuild watch actions.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.29.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.29.3

38. v2.29.2 Aug 16, 2024 · release notes

    Docker Compose v2.29.2 adds x-initSync extension to guarantee an initial sync on watch start.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.29.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.29.2

    └──▷ USE IT
    Force an initial sync of watched files when starting docker compose watch, so containers always start with up-to-date content even before the first file change.
    yaml copy

    services:
      app:
        build: .
        develop:
          watch:
            - action: sync
              path: ./src
              target: /app/src
              x-initSync: true

39. v2.29.1 Jul 23, 2024 · release notes

    Docker Compose v2.29.1 enriches JSON progress events with additional fields for better automation.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.29.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.29.1

    • Adds more fields to JSON progress events, enabling richer machine-readable output for CI/CD pipelines and tooling that parses --progress json.

    1 detail in Everything

40. v2.29.0 Jul 17, 2024 · release notes

    Docker Compose v2.29.0 adds JSON stream progress output and a --prune option for the watch command.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.29.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.29.0

    └──▷ TRY IT
    Automatically remove orphaned containers during a watch session as services are removed from your compose file.
    copy

    $ docker compose watch --prune

    • Adds JSON stream progress writer for machine-readable output during compose operations.
    • Adds --prune flag to docker compose watch, automatically removing containers for services no longer defined.

    2 details in Everything

41. v2.27.2 Jun 20, 2024 · release notes

    Adds --environment flag to the config command

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.27.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.27.2

42. v2.27.1 May 24, 2024 · release notes

    Docker Compose v2.27.1 adds gui/composeview command and --menu flag to open the Docker Desktop navigation menu.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.27.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.27.1

    └──▷ USE IT
    Use the new gui/composeview command to trigger the Docker Desktop navigation menu from the CLI.
    shell copy

    docker compose gui/composeview

    • Add gui/composeview as part of available commands
    • Add documentation for --menu up option and COMPOSE_MENU environment var

    2 details in Everything

43. v2.27.0 Apr 24, 2024 · release notes

    Docker Compose v2.27.0 adds --abort-on-container-failure, --all-resources, and build.entitlements support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.27.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.27.0

    • Introduce --abort-on-container-failure flag to fail the entire compose process if any container exits with a non-zero status.
    • Introduce --all-resources flag to include resources not explicitly used by services in the output or state.
    • Add support for the build.entitlements field in docker-compose.yml to specify build entitlements.

    3 details in Everything

44. v2.26.0 Mar 22, 2024 · release notes

    Docker Compose v2.26.0 adds Mutagen file sync, compose annotations, config --variables, and a navigation menu.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.26.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.26.0

    • Introduces compose config --variables subcommand to list available compose model variables
    • Adds Mutagen synchronized file share integration for development workflows
    • Adds support for container annotations in compose files

    3 details in Everything

45. v2.25.0 Mar 15, 2024 · release notes

    Adds --watch flag to docker compose up for file-change-driven container restarts

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.25.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.25.0

    └──▷ TRY IT
    Develop applications by letting Docker detect file changes and restart services automatically.
    copy

    $ docker compose up --watch

    • Add --watch flag to up subcommand to automatically restart containers when source files change

    1 detail in Everything

46. v2.24.7 Mar 6, 2024 · release notes

    Adds --watch flag to docker compose up for automatic restarts on file changes.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.24.7 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.24.7

    └──▷ TRY IT
    Run a service in development mode that automatically restarts whenever source code or config files are modified.
    copy

    $ docker compose up --watch

    Ensure orphaned containers created by previous runs are cleaned up when starting a new stack.
    copy

    $ COMPOSE_REMOVE_ORPHANS=true docker compose up

    • Adds --watch flag to up to enable live reloading of containers when source files change
    • Respects the COMPOSE_REMOVE_ORPHANS environment variable during up operations

    2 details in Everything

47. v2.24.4 Jan 29, 2024 · release notes

    Docker Compose v2.24.4 adds storage_opt support for volume driver options.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.24.4 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.24.4

48. v2.24.0 Jan 11, 2024 · release notes

    Docker Compose v2.24.0 adds attach, logs --index, stats command and --with-dependencies build flag

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.24.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.24.0

    └──▷ TRY IT
    View resource consumption (CPUCPUThe main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware./Memory) for all services in the current project
    copy

    $ docker compose stats

    Filter ps output to show only containers created by the current compose run that are not defined in the configuration (orphans)
    copy

    $ docker compose ps --orphans

    Build a service and all of its transitive dependencies automatically
    copy

    $ docker compose build --with-dependencies my_service

    • Introduces the new docker compose attach subcommand to attach to running services
    • Adds ps --orphans flag to include or exclude orphaned containers in project listings
    • Adds logs --index flag to select specific replica containers from logs output
    • Adds --with-dependencies flag to docker compose build for transitive dependency building
    • Introduces the new docker compose stats command to view resource usage of compose services

    5 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !service hash computation logic has been updated to fully ignore replicas/scale. Due to this change, after upgrade all services will be recreated.
49. v2.23.2 Nov 22, 2023 · release notes

    Docker Compose v2.23.2 adds build.tags support to docker compose push and ensures watch builds with latest source.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.23.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.23.2

    • push now considers build.tags when pushing images
    • watch command forces a rebuild using the latest source code changes

    2 details in Everything

50. v2.23.1 Nov 16, 2023 · release notes

    Docker Compose v2.23.1 adds --resolve-image-digests flag for compose publish to seal image digests.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.23.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.23.1

    └──▷ USE IT
    Publish your stack with pinned image digests to prevent tag drift in production environments.
    shell copy

    docker compose publish --resolve-image-digests ./docker-compose.yml

    • Introduces the --resolve-image-digests CLI flag for the compose publish command to ensure published service images use fixed digests rather than tags.
    • Rejects compose files that specify a driver or template_driver on secrets or configs entries, enforcing stricter schema validation.

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Compose now rejects configuration files using secrets.*.driver, secrets.*.template_driver, configs.*.driver, or configs.*.template_driver keys that were previously accepted.
    • !The compose start command now fails immediately if a dependency listed in the service is missing, rather than continuing execution.
51. v2.23.0 Oct 18, 2023 · release notes

    Docker Compose v2.23.0 adds dry-run to publish, COMPOSE_ENV_FILES env var, and sync+restart watch action

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.23.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.23.0

    └──▷ TRY IT
    Check what images would be published by compose publish without actually pushing them
    copy

    $ docker compose publish --dry-run

    Load multiple environment files in addition to the default .env using the new COMPOSE_ENV_FILES variable
    copy

    $ COMPOSE_ENV_FILES=".env.dev,.env.local" docker compose up

    • Adds --dry-run flag to the compose publish command to simulate publishing without pushing images
    • Introduces the COMPOSE_ENV_FILES environment variable to specify a list of .env files for Compose to load
    • Adds sync+restart as a supported action in the develop.sync section of compose watch configurations

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !compose ps output is now truncated by default to align with Docker CLI; use --no-trunc to see full output
52. v2.22.0 Sep 21, 2023 · release notes

    Docker Compose v2.22.0 adds publish, scale commands and --pull=policy flag

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.22.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.22.0

    └──▷ USE IT
    Experimentally publish a service in a Compose project
    shell copy

    docker compose publish <service>

    Scale a specific service to 5 replicas via the new scale command
    shell copy

    docker compose scale <service>=5

    • Adds the new publish command (experimental) for publishing services
    • Adds a new top-level scale command to adjust replica counts
    • Adds policy option to the --pull flag to control image pulling behavior
    • watch command is now generally available (GA) and can be run as docker compose watch

    4 details in Everything

53. v2.21.0 Aug 30, 2023 · release notes

    Docker Compose v2.21.0 adds multi-document YAML and remote Git file loading

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.21.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.21.0

    • Adds support for multi-document YAML files in compose configuration
    • Adds experimental include support for loading remote Compose files from Git repositories

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The format of docker compose ps output and docker compose ps --format=json output has changed to align with docker ps
54. v2.20.3 Aug 11, 2023 · release notes

    Docker Compose v2.20.3 adds tar sync support for watch mode, enabling batched file event synchronization.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.20.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.20.3

    └──▷ USE IT
    Verify tab-completion works correctly when specifying service profiles during development.
    shell copy

    docker compose --profile<press-tab>

    • Adds shell completion for the --profile flag
    • Enables the tar-based watcher implementation by default for docker compose watch

    2 details in Everything

55. v2.20.2 Jul 19, 2023 · release notes

    Adds depends_on.required attribute to compose files for conditional service dependencies

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.20.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.20.2

    • Adds support for the depends_on.required attribute in docker-compose YAML configurations

    1 detail in Everything

56. v2.20.0 Jul 11, 2023 · release notes

    Docker Compose v2.20.0 adds compose wait command, --builder flag for buildx, and compose file include directive

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.20.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.20.0

    └──▷ USE IT
    Build services using a specific Buildx builder instead of the default one via environment variable
    shell copy

    BUILDX_BUILDER=my-builder docker compose up --build

    • Add docker compose wait by @ulyssessouza in https://github.com/docker/compose/pull/10742
    • Add support of --builder and BUILDX_BUILDER by @glours in https://github.com/docker/compose/pull/10745
    • Support attach by @ndeloof in https://github.com/docker/compose/pull/10700
    • Add support for include in https://github.com/compose-spec/compose-go/pull/416

    4 details in Everything

57. v2.19.0 Jun 21, 2023 · release notes

    Docker Compose v2.19.0 adds service selection to down, --progress UI style config, and run --cap-add.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.19.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.19.0

    └──▷ TRY IT
    Stop a specific container in a multi-service stack without tearing down the rest.
    copy

    $ docker compose down web-worker

    Configure the CLI to display progress using a minimal, text-only interface.
    copy

    $ docker compose --progress plain up

    Run a command with elevated capabilities for maintenance tasks.
    copy

    $ docker compose run --cap-add=NET_ADMIN app sh -c 'ip addr'

    • Adds the ability to select a specific service to stop when running docker compose down <service>
    • Adds --progress flag to docker compose up and other commands to configure the progress UI style
    • Adds --cap-add support to docker compose run for maintenance commands using the service image

    3 details in Everything

58. v2.18.0 May 16, 2023 · release notes

    Docker Compose v2.18.0 adds dry-run build, viz subcommand, --no-path-resolution, and COMPOSE_ANSI env var

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.18.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.18.0

    • docker compose build --dry-run shows what would be built without creating any images.
    • New docker compose viz subcommand for visualizing service dependencies.

    2 details in Everything

59. v2.17.3 Apr 20, 2023 · release notes

    Adds --dry-run to run, create, and down commands; improves NO_COLOR support.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.17.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.17.3

    └──▷ TRY IT
    Verify that docker compose run would work without actually starting the service
    copy

    $ docker compose run --dry-run myservice command arg

    Simulate tearing down stacks to check what resources would be removed
    copy

    $ docker compose down --dry-run

    • --dry-run flag added to docker compose run to simulate without creating resources
    • --dry-run flag added to docker compose create to validate configuration without starting services
    • --dry-run flag added to docker compose down to simulate resource teardown without acting
    • Supports disabling colored output via NO_COLOR environment variable instead of relying on ANSI TUITUIA text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency.

    4 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !YAML boolean values must now use YAML 1.2 standard (true/false); legacy values like yes, on, True, etc., are rejected
    • !Project names must strictly be lowercase alphanumeric, -, or _ starting with a letter/number; other characters are rejected
60. v2.17.0 Mar 22, 2023 · release notes

    Docker Compose v2.17.0 adds --wait-timeout to up, additional_contexts build support, watch file delete handling, and dry-run for stop/restart/exec

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.17.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.17.0

    • --wait-timeout flag on docker compose up controls the timeout for containers becoming healthy
    • additional_contexts key in build service config supports extra Dockerfile build contexts
    • ignore attribute in watch triggers excludes files or directories from triggering reloads
    • File delete and rename events are now handled by the watch feature
    • dry-run mode added to stop, restart, exec, pull, and push commands

    5 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Project names must now be lowercase alphanumeric characters, -, or _ and start with a letter/number; previously allowed characters are now invalid.
    • !Only YAML 1.2 boolean values (true / false) are accepted for compose files; deprecated YAML 1.1 values (~y|Y|yes|Yes|YES|n|N|no|No|NO|True|TRUE|False|FALSE|on|On|ON|off|Off|OFF~) are no longer supported and will cause parsing errors.
    • !Duplicate mapping keys (<<) for merging YAML anchors are now rejected, preventing silent overrides.
61. v2.16.0 Feb 8, 2023 · release notes

    Docker Compose v2.16.0 adds compose create options and experimental CLI commands

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.16.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.16.0

    └──▷ USE IT
    Launch isolated services while automatically removing stale containers and scaling instances.
    shell copy

    docker compose create --remove-orphans --scale=web=3

    Build the project dependencies and push them to the registry in one atomic operation.
    shell copy

    docker compose build --push

    • Adds --remove-orphans flag to compose create command.
    • Adds --scale flag to compose create command.
    • Introduces the experimental watch subcommand for source-driven service updates.
    • Introduces the experimental alpha dry-run subcommand for simulation without side effects.
    • Supports docker compose build --push to build and push images in a single step.

    5 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The convert command has been renamed to config.
62. v2.15.1 Jan 9, 2023 · release notes

    Adds uts namespace support to Compose projects.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.15.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.15.1

    • Add support for uts namespace

    1 detail in Everything

63. v2.15.0 Jan 5, 2023 · release notes

    Docker Compose v2.15.0 adds privileged builds and CLI flags for build/pull control

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.15.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.15.0

    └──▷ TRY IT
    Pull services without building images that have a pre-built Dockerfile defined in the compose file
    copy

    $ docker compose --ignore-buildable pull

    • --ignore-buildable flag to ignore images marked as buildable during pull operations
    • Support for the privileged attribute within the service.build section of compose files

    2 details in Everything

64. v2.14.2 Dec 20, 2022 · release notes

    Docker Compose v2.14.2 adds DOCKER_DEFAULT_PLATFORM support and dependency start detection.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.14.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.14.2

    └──▷ USE IT
    Force all containers in a compose stack to run on ARM64ARM64The 64-bit instruction set architecture from ARM Holdings, used in modern mobile chips, Apple Silicon, and cloud server CPUs; tools target it to run natively on those platforms without emulation overhead. regardless of host architecture.
    shell copy

    DOCKER_DEFAULT_PLATFORM=linux/arm64 docker compose up -d

    • Uses the DOCKER_DEFAULT_PLATFORM environment variable to determine the platform when creating containers

    1 detail in Everything

65. v2.14.1 Dec 15, 2022 · release notes

    Docker Compose v2.14.1 adds --parallel, --include-deps, and --timestamp flags to improve workflow control

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.14.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.14.1

    └──▷ TRY IT
    Push a stack and all its dependencies with a single command
    copy

    $ docker compose push --include-deps

    Run a stack but restrict concurrency to avoid overwhelming the engine
    copy

    $ docker compose up --parallel 2

    • Adds --parallel flag to docker compose up to limit concurrent engine calls
    • Adds --include-deps flag to the compose push command to also push dependent images
    • Adds --timestamp option to compose up output

    3 details in Everything

66. v2.14.0 Dec 2, 2022 · release notes

    Docker Compose v2.14.0 adds oom_score_adj service field and tmpfs mode permissions.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.14.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.14.0

    • Adds oom_score_adj field to the service definition for controlling OOMOOMAn out-of-memory condition: a program requests more memory than the system or device can provide. The allocation fails or the operating system may stop the process. killer priority
    • Adds mode field for tmpfs mount permissions in the service definition

    2 details in Everything

67. v2.13.0 Nov 23, 2022 · release notes

    Docker Compose v2.13.0 adds --no-consistency flag to convert and --build to compose run

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.13.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.13.0

    └──▷ USE IT
    Convert a compose file to JSON/YAML without enforcing schema consistency checks
    shell copy

    docker compose convert --no-consistency docker-compose.yml

    Run a service and automatically build its image if missing or out of date
    shell copy

    docker compose run --build <service_name>

    • Adds --no-consistency flag to the convert subcommand
    • Adds --build flag to compose run for building images during execution
    • Displays creation warnings from the engine in CLI output

    3 details in Everything

68. v2.12.0 Oct 18, 2022 · release notes

    Docker Compose v2.12.0 adds --quiet flag to push for silent image uploads

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.12.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.12.0

69. v2.11.0 Sep 14, 2022 · release notes

    Docker Compose v2.11.0 adds platforms build directive and service-scoped log filtering.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.11.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.11.0

    • Compose.yaml now accepts a platforms list to specify target architectures for images built by compose.

    1 detail in Everything

70. v2.10.0 Aug 19, 2022 · release notes

    Docker Compose v2.10.0 adds Windows/arm64 and Linux/riscv64 binary support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.10.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.10.0

    • Build windows/arm64 binaries
    • Build linux/riscv64 binaries

    2 details in Everything

71. v2.8.0 Jul 29, 2022 · release notes

    Adds --pull flag to control image pulling behavior during deployment

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.8.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.8.0

    • Introduces the --pull CLI argument to the compose run lifecycle to give users explicit control over when images are pulled

    1 detail in Everything

    └──▷ BREAKING ON UPGRADE

    • !Docker Compose v2.8.0 now recreates networks, volumes, secrets, and configs with new names using - as a separator instead of _, which may prevent connection to existing resources; upgrade to v2.9.0 to resolve
    • !Image names now use - as the default separator instead of other characters
72. v2.6.1 Jun 23, 2022 · release notes

    Compose v2.6.1 adds env var secrets and respects deploy limits

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.6.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.6.1

    └──▷ USE IT
    Control whether stale containers persist after a stack shutdown.
    shell copy

    COMPOSE_REMOVE_ORPHANS=true docker compose down

    Enforce resource quotas directly in the Compose file via standard deployment keys.
    📍deploy: limits: cpus: 0.5 memory: 50M pids: 10
    • COMPOSE_REMOVE_ORPHANS env var now controls orphan cleanup on compose down
    • deploy.limits.cpus and deploy.limits.pids are respected when scheduling services

    2 details in Everything

73. v2.6.0 May 30, 2022 · release notes

    Docker Compose v2.6.0 adds tags to build configs and DOTENV import support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.6.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.6.0

    • Adds the tags property to the build section in docker-compose files to specify custom image tags
    • Automatically imports environment variables from .env files into the host process os environment

    2 details in Everything

74. v2.5.1 May 17, 2022 · release notes

    New compose down exit=0 behavior and cp to all containers

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.5.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.5.1

    └──▷ USE IT
    Silently skip teardown steps in CI/CD pipelines if the environment was never started.
    shell copy

    docker compose down; echo "Teardown complete (exit $?)"

    Push a binary to every instance of a backend service for debugging or updates.
    shell copy

    docker compose cp update.sh backend:/tmp/

    • compose down now exits with code 0 when there are no services or networks to remove.
    • The compose cp command defaults to copying files to all containers of a service instead of just one.

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !compose down now rejects arguments other than the service name(s), preventing accidental execution on wrong targets.
75. v2.5.0 Apr 29, 2022 · release notes

    Docker Compose v2.5.0 adds build secrets support, ppc64le platform support, and pull policy enforcement.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.5.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.5.0

    • Adds build.secrets support to define build-time secrets in compose files
    • Adds pull_policy support to control image pulling behavior for services
    • Adds ppc64le architecture support for docker compose binary

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The project name must now be lowercase, previously allowed mixed case
76. v2.4.1 Apr 4, 2022 · release notes

    Compose v2.4.1 adds automatic Docker CLI autoremove and SSH config usage for builds.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.4.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.4.1

    • Uses the Docker CLI directly to pass --autoremove flag during cleanup operations
    • Respects ~/.ssh/config when building images via compose up

    2 details in Everything

77. v2.4.0 Apr 1, 2022 · release notes

    Docker Compose v2.4.0 adds SSH auth support, COMPOSE_PROJECT_NAME enforcement, and image caching flags.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.4.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.4.0

    └──▷ USE IT
    Build images while forwarding the current user's SSH agent keys for cloning private dependencies.
    shell copy

    docker compose --ssh default build

    Force all operations (up, down, ps) to use a specific project namespace regardless of the current directory or file name.
    shell copy

    COMPOSE_PROJECT_NAME=prod-env docker compose up -d

    • Adds --ssh flag to pass SSH authentications defined in the compose file or via CLI
    • Enforces COMPOSE_PROJECT_NAME environment variable on all commands for project name consistency
    • Adds cache_from, cache_to, cache_no, and pull flags to control image build caching behavior

    3 details in Everything

78. v2.3.4 Mar 25, 2022 · release notes

    Compose v2.3.4 re-enables --filter on ps command with enhanced documentation

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.3.4 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.3.4

    • kill subcommand simplifies invocation by requiring only the project name argument.

    1 detail in Everything

79. v2.3.3 Mar 9, 2022 · release notes

    Adds device_cgroup_rules support and plain-text progress mode.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.3.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.3.3

    • Adds device_cgroup_rules to the compose file format for container device cgroup configuration
    • Enables plain text progress output when ansi=never environment variable is set

    2 details in Everything

80. v2.3.0 Mar 4, 2022 · release notes

    docker compose ls gains --filter and env var COMPOSE_REMOVE_ORPHANS; run/exec gain -i/-t

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.3.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.3.0

    └──▷ TRY IT
    Force removal of orphaned containers on up without passing flags, via the new environment variable.
    copy

    $ COMPOSE_REMOVE_ORPHANS=true docker compose up -d

    Attach a pseudo-TTY to an interactive run command.
    copy

    $ docker compose run -i -t service-name /bin/bash

    • Enables the COMPOSE_REMOVE_ORPHANS environment variable to force --remove-orphans behavior on commands that do not support the flag directly.
    • Adds -i and -t flags to docker compose run and docker compose exec.

    2 details in Everything

81. v2.2.3 Jan 6, 2022 · release notes

    Docker Compose v2.2.3 adds :z/:Z SELinuxSELinuxA mandatory access control system built into the Linux kernel, maintained by the NSA and Red Hat, that enforces fine-grained policies restricting what processes can access, even if they run as root. labels to volumes and relaxes compose ps/cp requirements

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.2.3 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.2.3

    └──▷ USE IT
    Mount a volume with SELinux labels for containers running in a restrictive environment.
    shell copy

    docker compose run -v ./data:/data:Z app

    Copy files from a container that has exited without needing the full project state.
    shell copy

    docker compose cp stopped_container:/path/to/file ./local_path

    • Add :z and :Z SELinux labels to volume bind mounts
    • compose images now lists images of containers that have been created but not yet started
    • Propagation of GroupAdd from ServiceConfig to HostConfig so group additions are applied during container creation

    3 details in Everything

82. v2.1.1 Nov 8, 2021 · release notes

    Docker Compose v2.1.1 adds up --wait condition support and exec inherited environment variable handling.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.1.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.1.1

    • Introduces the --wait flag for docker compose up, allowing users to specify a custom wait condition instead of the default timeout
    • Adds support for inherited environment variables when using docker compose exec

    2 details in Everything

83. v2.1.0 Nov 3, 2021 · release notes

    Adds DOCKER_DEFAULT_PLATFORM, COMPOSE_COMPATIBILITY via .env, and classic builder support.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.1.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.1.0

    • Add support for DOCKER_DEFAULT_PLATFORM environment variable
    • COMPOSE_COMPATIBILITY can be set by .env file
    • Add support for EnableIPv6

    3 details in Everything

84. v2.0.1 Sep 30, 2021 · release notes

    Docker Compose v2 introduces plugin-as-binary mode and SHA256SHA256A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. release checksums

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.0.1 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.0.1

    └──▷ TRY IT
    Pass multiple status values to filter running and stopped containers.
    copy

    $ compose ps --status running --status stopped

    • compose can now run as a standalone binary (the docker compose subcommand is still the primary CLI entry point for most users)
    • SHA256 checksums are included in every Compose v2 release

    2 details in Everything

85. v2.0.0 Sep 28, 2021 · release notes

    Docker Compose v2.0 introduces new env var ignore option, attach mode, and output flags

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.0.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v2.0.0

    └──▷ USE IT
    Start a stack without worrying about orphaned containers left by previous runs.
    shell copy

    COMPOSE_IGNORE_ORPHANS=1 docker compose up -d

    Export the resolved configuration of an existing project to a file for inspection or debugging.
    shell copy

    docker compose --project-name myapp config --output resolved.yaml

    • COMPOSE_IGNORE_ORPHANS environment variable allows ignoring orphaned containers during up/down operations.
    • --project-name flag on compose exec and compose down removes the requirement for the original compose file by allowing operation against an existing project.
    • compose config --output flag added to redirect configuration output to a file instead of stdout.
    • build.network and build.extrahosts keys supported in the compose file format.
    • compose up --attach new subcommand/flag enables attaching to the main service containers immediately on start.

    +4 more show less

    • COMPOSE_IGNORE_ORPHANS
    • --project-name
    • build.network
    • build.extrahosts

    9 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Compose v2 architecture and installation instructions differ from v1; consider installing compose-switch for backward compatibility.
86. 1.29.0 Apr 6, 2021 · release notes

    Docker Compose 1.29 adds profile filtering to config and depends_on conditions

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.29.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.29.0

    └──▷ USE IT
    Generate the effective configuration for only specific profiles, ignoring others.
    shell copy

    docker-compose config --profile web --profile db

    Configure a service to wait until another service has exited with status 0 before starting.
    yaml copy

    depends_on:
      healthcheck-service:
        condition: service_completed_successfully

    • Adds --profile flag to docker-compose config for filtering services by profile.
    • Adds conditional dependency support in depends_on allowing waits for service completion.

    2 details in Everything

87. 1.28.0 Jan 20, 2021 · release notes

    Adds Nvidia GPUGPUA graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. support via device requests, service profiles, and log/ANSI output flags

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.28.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.28.0

    • Adds COMPOSE_PARAMIKO_SSH environment variable to enable the previous Paramiko-based SSH implementation
    • Adds new flag for ANSI output control (shell)
    • Adds support for Nvidia GPUsGPUsA graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. via device requests in service configurations
    • Adds a new flag to disable log prefixes

    4 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The SSH connection approach changes from Paramiko to shell-out to the local SSH client (previous behavior can be restored with COMPOSE_PARAMIKO_SSH)
88. 1.27.0 Sep 7, 2020 · release notes

    Docker Compose v1.27.0 unifies compose formats and adds IPCIPCInter-process communication, ways for separate programs to exchange data or signals. Examples include pipes, sockets and shared memory. mode and env var support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.27.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.27.0

    └──▷ TRY IT
    Pass a specific project name to the container when using docker-compose run.
    copy

    $ COMPOSE_PROJECT_NAME=my-app docker-compose run service-name

    Ensure docker-compose run uses the host's Docker CLI for building instead of the embedded Go builder.
    copy

    $ COMPOSE_DOCKER_CLI_BUILD=1 docker-compose run service-name

    • COMPOSE_PROJECT_NAME environment variable is now passed into containers in docker-compose run commands.
    • Setting COMPOSE_DOCKER_CLI_BUILD=1 makes docker-compose run invoke the Docker CLI for building images via docker build.
    • network_mode is now parsed inside the build section of services.

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Docker Compose no longer supports Python 2.7.
89. 1.26.0 Jun 3, 2020 · release notes

    Adds --attach-dependencies flag to docker compose up and COMPOSE_COMPATIBILITY env var

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.26.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.26.0

    └──▷ USE IT
    Run compose up in compatibility mode for older docker engine versions.
    shell copy

    export COMPOSE_COMPATIBILITY=1 && docker-compose up

    Attach to dependent services' logs immediately when starting the stack.
    shell copy

    docker-compose up --attach-dependencies

    • COMPOSE_COMPATIBILITY environment variable enables compatibility mode options.
    • up subcommand gains --attach-dependencies flag to attach to dependency services.

    2 details in Everything

90. v1.25.2 Jan 20, 2020 · release notes

    Add COMPOSE_COMPATIBILITY environment variable for compatibility options

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.25.2 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout v1.25.2

    └──▷ USE IT
    Enable legacy compatibility mode for older compose file formats or behaviors.
    shell copy

    COMPOSE_COMPATIBILITY=1 docker-compose up

91. 1.25.0 Nov 18, 2019 · release notes

    Docker Compose 1.25.0 adds --no-interpolate, --quiet, --no-rm flags and BuildKitBuildKitA build engine for Docker images, maintained by Moby, that replaces the legacy Docker builder with parallel layer execution, cache mounts, and secret handling — giving cyber tools faster, more reproducible container builds. integration.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.25.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.25.0

    └──▷ TRY IT
    Render the compose file structure without expanding environment variables for debugging.
    copy

    $ docker-compose config --no-interpolate

    Enable BuildKit for all Compose build operations by setting the required environment variables.
    copy

    $ export DOCKER_BUILDKIT=1 COMPOSE_DOCKER_CLI_BUILD=1 && docker-compose build

    • docker-compose config supports --no-interpolate to disable variable interpolation in the rendered output
    • docker-compose build accepts --quiet flag to suppress output during image building
    • Compose now supports Docker BuildKit via environment variables DOCKER_BUILDKIT=1 and COMPOSE_DOCKER_CLI_BUILD=1

    3 details in Everything

92. 1.24.0 Mar 28, 2019 · release notes

    Docker Compose 1.24.0 adds SSH protocol support and --all flag for ps.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.24.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.24.0

    └──▷ USE IT
    List all containers including stopped one-off instances created by run.
    shell copy

    docker-compose ps --all

    • Added support for connecting to the Docker Engine using the ssh protocol.
    • Added a --all flag to docker-compose ps to include stopped one-off containers in the command's output.

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Compose will no longer accept whitespace in variable names sourced from environment files.
93. 1.23.0 Oct 30, 2018 · release notes

    Adds --hash to docker-compose config, parallel build support, and improved container naming for Docker Compose v1.23.0

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.23.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.23.0

    └──▷ TRY IT
    Verify config integrity before deploying to detect accidental changes
    copy

    $ docker-compose config --hash

    Speed up build pipelines by parallelizing image builds
    copy

    $ docker-compose build --parallel

    • docker-compose config now supports the --hash flag, outputting a configuration hash per service
    • New --parallel flag for docker-compose build allows simultaneous image builds (up to 5)
    • Container naming scheme changes from <project>_<service>_<index> to <project>_<service>_<index>_<slug>

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The default container naming format changes to include a random <slug>, breaking scripts that relied on the previous <project>_<service>_<index> pattern
94. 1.22.0 Jul 17, 2018 · release notes

    Adds rollback_config, init parameter, and extension field support to Compose v3.7

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.22.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.22.0

    └──▷ USE IT
    Define a rollback strategy for a service when using Compose file version 3.7
    yaml copy

    version: '3.7'
    services:
      web:
        image: myapp
        deploy:
          rollback_config:
            parallelism: 2
            delay: 10s

    Enable the service's init process (e.g., tini) to handle signals correctly
    yaml copy

    version: '3.7'
    services:
      app:
        image: myapp
        init: true

    Use custom extension fields (prefixed with x-) in service, network, volume, secret, or config sections
    yaml copy

    version: '3.7'
    services:
      db:
        image: postgres
        x-custom-field: custom_value
    networks:
      net1:
        x-net-extension: true

    • Added rollback_config support to the deploy configuration block in Compose file format version 3.7
    • Added init parameter support in service configurations for Docker Engine 18.06.0+
    • Added support for extension fields in service, network, volume, secret, and config configurations in Compose format v3.7

    3 details in Everything

95. 1.21.0 Apr 10, 2018 · release notes

    Docker Compose 1.21.0 adds platform, CPUCPUThe main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. real-time, workdir flags and parallel pull

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.21.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.21.0

    └──▷ TRY IT
    Run a command inside a running service with the working directory set to /app without modifying the service definition.
    copy

    $ docker-compose exec --workdir /app web /bin/bash

    Disable parallel pulls for older Docker Engine versions that do not support concurrent image pulls.
    copy

    $ docker-compose pull --no-parallel

    • docker-compose exec now supports the --workdir flag to set the working directory for the executed command.
    • docker-compose build now supports the --compress flag to compress the build context.
    • docker-compose pull runs in parallel by default; use --no-parallel to opt out and suppress the deprecation warning for --parallel.
    • Compose file format 2.4 adds support for the platform parameter in service definitions to target specific architectures during deployment and build.
    • Compose file format 2.2+ adds support for the cpu_rt_period and cpu_rt_runtime parameters in service definitions for real-time CPU scheduling.

    +2 more show less

    • Compose file format 2.1+ adds support for the cpu_period parameter in service definitions to restrict CPU usage intervals.
    • Compose file format 2.x adds support for the isolation parameter in build configurations to specify container isolation mode (e.g., process or hyper-v).

    7 details in Everything

96. 1.20.0 Mar 20, 2018 · release notes

    Docker Compose 1.20.0 adds tmpfs.size support, --log-level CLI flag, and several new run/pull options

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.20.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.20.0

    └──▷ USE IT
    Set the log level to debug for verbose troubleshooting of compose operations
    shell copy

    docker-compose --log-level debug up -d

    Pull all dependent images when running a subset of services
    shell copy

    docker-compose pull --include-deps frontend

    • tmpfs.size property now supported in volume mappings for Compose file formats 3.6 and 2.3+
    • Top-level docker-compose command now accepts the --log-level flag (debug, info, warning, error, critical)
    • --include-deps flag added to docker-compose pull to pull dependencies along with specified services
    • --use-aliases flag added to docker-compose run to use network aliases declared in service config
    • Long-form --detach option now available for exec, run, and up commands

    5 details in Everything

97. 1.19.0 Feb 7, 2018 · release notes

    Docker Compose 1.19 adds volume preservation control, parallel execution limits, and network priority to Compose files.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.19.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.19.0

    └──▷ USE IT
    Recreate services and ensure dependencies are updated regardless of config changes
    shell copy

    docker compose up --always-recreate-deps -d

    Prevent volume data recovery for anonymous volumes during update
    shell copy

    docker compose up -V

    • docker compose up now supports --renew-anon-volumes (-V) to prevent recovering volume data from previous containers for anonymous volumes
    • Added COMPOSE_PARALLEL_LIMIT environment variable to limit simultaneous parallel operations (default 64)
    • docker compose up gains --always-recreate-deps flag to force recreation of dependent services alongside their owner
    • Compose files support priority key in service network mappings to define connection order
    • Added ${VAR:?err} and ${VAR?err} variable interpolation syntax for mandatory variable checks

    +2 more show less

    • COMPOSE_IGNORE_ORPHANS environment variable can be set to suppress orphan container detection warnings
    • COMPOSE_FORCE_WINDOWS_HOST environment variable forces parsing of volume definitions as Windows-style even on UNIX

    7 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !On UNIX platforms, interactive run and exec commands now require the docker CLI; set COMPOSE_INTERACTIVE_NO_CLI=1 to revert
98. 1.18.0 Dec 18, 2017 · release notes

    Docker Compose v1.18 adds shm_size and isolation to builds, custom resource names, --label/--timeout/--memory CLI flags

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.18.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.18.0

    └──▷ USE IT
    Build an image with a specific memory limit using the new CLI flag.
    shell copy

    docker-compose build --memory=512m

    Run a service interactively with custom labels for tracking or identification.
    shell copy

    docker-compose run --label version=1.0 --label env=test app

    Define a build step with shared memory size and OS isolation in compose.yml.
    config copy

    build:
      shm_size: '1gb'
      isolation: process

    • Adds --memory flag to docker-compose build to specify container memory limits during image builds.
    • Adds --label flag to docker-compose run for setting labels on the created service instance.
    • Adds --timeout flag to docker-compose down to configure the time allowed for container stopping.
    • Supports shm_size parameter in build configuration sections of docker-compose.yml.
    • Supports isolation parameter in service definitions within docker-compose.yml.

    +3 more show less

    • Allows custom names for network, secret, and config definitions in Compose file v3.5 and up.
    • Supports extra_hosts in build configuration sections.
    • Supports long syntax for volume entries in Compose file v2.3 and up.

    8 details in Everything

99. 1.17.0 Nov 2, 2017 · release notes

    Docker Compose v1.17 adds version 3.4 support, new build options, extension fields, and --no-start flag to the up command.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.17.0 https://github.com/docker/compose.git
    # already have the repo? check out this version:
    $ git checkout 1.17.0

    └──▷ USE IT
    Configure a service build with new v3.4 options like cache_from, target, and network.
    config copy

    services:
      web:
        build:
          context: .
          cache_from:
            - myapp:latest
          target: prod
          network: backend

    Create all defined resources (networks, volumes, containers) without automatically starting the services.
    shell copy

    docker-compose up --no-start

    • Adds support for extension fields (x-*) in compose file versions 2.x and 3.4
    • Introduces version 3.4 of the docker-compose.yml specification with cache_from, network, and target build options
    • Adds the order parameter to the update_config section in v3.4 files
    • Allows setting a custom name for volumes using the name parameter in volume definitions
    • Adds support for the shm_size option in build configuration for version 2.3

    +1 more show less

    • Adds the --no-start flag to the up command to create resources without starting services

    6 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The create command is deprecated in favor of the new --no-start option on the up command
100. 1.16.0 Aug 31, 2017 · release notes

     Docker Compose 1.16 adds version 2.3 support with target and start_period, plus --no-ansi CLI flag

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.16.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.16.0

     └──▷ TRY IT
     Parse or validate Compose files in CI systems where ANSI output breaks parsing.
     copy

     $ docker-compose --no-ansi config

     • Adds blkio_config parameter support in service definitions for Compose file formats 2.x
     • Adds name parameter to volume definitions for specifying custom volume names
     • Adds target parameter support in network configurations for Compose file version 2.3
     • Adds start_period parameter support in healthcheck configurations for Compose file version 2.3
     • Adds --no-ansi CLI flag to suppress ANSI control characters in output

     5 details in Everything

101. 1.15.0 Jul 26, 2017 · release notes

     Adds network support in build sections, service:<name> pid mode, storage_opt, and --quiet flag to pull

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.15.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.15.0

     • Adds network parameter to build configurations (v2.2+ files)
     • Supports pid: service:<name> syntax in service definitions (v2.1+ files)
     • Adds storage_opt parameter support in service definitions (v2.1+) for non-v3 formats
     • Adds --quiet flag to docker-compose pull to suppress progress output

     4 details in Everything

102. 1.14.0 Jun 19, 2017 · release notes

     Compose 1.14 adds CPUCPUThe main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. resource keys (cpu_count, cpu_percent, cpus), build labels, and credential_spec/configs support in version 3.3.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.14.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.14.0

     • Adds support for build labels in Compose file versions 2.1, 2.2, and 3.3.
     • Adds shorthand -u flag for --user in the docker-compose exec command.

     2 details in Everything

103. 1.13.0 May 2, 2017 · release notes

     Docker Compose v1.13.0 adds init and scale keys to service definitions in Compose file format 2.2.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.13.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.13.0

     └──▷ USE IT
     Launch a service defined in Compose file v2.2 with an embedded entrypoint (init) and override the replica count via CLI.
     shell copy

     docker-compose up --scale myservice=5

     Define a service that runs an init process and sets a default scale in docker-compose.yml (format version 2.2).
     text copy

     version: '2.2'
     services:
       myapp:
         image: alpine
         init: true
         scale: 3

     Configure IPAM options for a network in Compose file format 2.2.
     text copy

     version: '2.2'
     networks:
       default:
         ipam:
           driver: default
           options:

     • Adds the --scale flag to docker-compose up for overriding scaling values defined in Compose file version 2.2
     • Adds support for the init key in service definitions within Compose file version 2.2
     • Adds support for the scale key in service definitions within Compose file version 2.2
     • Adds support for the options key in the ipam section of network definitions

     4 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !docker-compose up now resets a service's scaling to its default value
104. 1.12.0 Apr 5, 2017 · release notes

     Docker Compose 1.12.0 adds docker-compose images command, expanded ports/volumes syntax, and several new CLI flags.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.12.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.12.0

     └──▷ USE IT
     Run docker-compose from a specific directory without changing the current working directory.
     shell copy

     docker-compose --project-directory /path/to/project up -d

     Scan for image usage in the current project to audit dependencies.
     shell copy

     docker-compose images

     Enable concurrent image pulling for faster startup times with multiple services.
     shell copy

     docker-compose pull --parallel

     • Added --project-directory PATH option to docker-compose that will affect path resolution for the project
     • Added support for COMPOSE_PATH_SEPARATOR environment variable
     • Added a new docker-compose images command that lists images used by the current project's containers
     • Added --parallel option to docker-compose pull that enables images for multiple services to be pulled simultaneously
     • Added --resolve-image-digests option to docker-compose config that pins the image version for each service to a permanent digest

     +12 more show less

     • Added --volumes option to docker-compose config that lists named volumes declared for that project
     • Added --build-arg option to docker-compose build
     • Added --volume <volume_mapping> (shorthand -v) option to docker-compose run to declare runtime volumes to be mounted
     • Added a --stop (shorthand -s) option to docker-compose rm that stops the running containers before removing them
     • Added a --exit-code-from SERVICE option to docker-compose up
     • Introduced version 3.2 of the docker-compose.yml specification with support for cache_from in the build section
     • Added support for pids_limit in service definitions (version 2.1)
     • Added support for mem_reservation in service definitions (version 2.x only)
     • Added support for dns_opt in service definitions (version 2.x only)
     • Added support for the new expanded ports syntax in service definitions
     • Added support for the new expanded volumes syntax in service definitions
     • Added support for port range to single port in port mappings

     17 details in Everything

105. 1.11.0 Feb 8, 2017 · release notes

     Adds docker-compose top subcommand and support for Compose file format v3.1 with secrets

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.11.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.11.0

     └──▷ USE IT
     View running processes for all services in the current compose project
     shell copy

     docker-compose top

     • Introduces the docker-compose top command to display processes running across services managed by Compose
     • Adds version 3.1 of the docker-compose.yml specification, enabling secret management and requiring Docker Engine 1.13.0+

     2 details in Everything

106. 1.10.0 Jan 17, 2017 · release notes

     Docker Compose 1.10.0 adds Compose file format version 3.0 support with healthcheck and sysctls capabilities.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.10.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.10.0

     • Introduces version: '3.0' to .docker-compose.yml for docker stack compatibility
     • Adds healthcheck parameter to service definitions in Compose file formats 2.1 and up
     • Adds depends_on support for healthcheck-based container dependencies in Compose file formats 2.1 and up
     • Adds sysctls parameter to service definitions in Compose file formats 2.1 and up
     • Adds userns_mode parameter to service definitions in Compose file formats 2.1 and up

     +3 more show less

     • Adds identifying labels to networks created by Compose in formats 2.1 and up
     • Adds identifying labels to volumes created by Compose in formats 2.1 and up
     • Adds stop_grace_period option to service definitions in Compose file formats 2.0 and up

     8 details in Everything

107. 1.9.0 Nov 16, 2016 · release notes

     Docker Compose 1.9.0 adds v2.1 spec support with volume/network labels, isolation, group_add and inline variable defaults.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.9.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.9.0

     • Adds version 2.1 of the docker-compose.yml specification for use with Docker Engine 1.12+
     • Added support for setting volume labels in docker-compose.yml via the new labels key in volume definitions
     • Added support for setting network labels in docker-compose.yml via the new labels key in network definitions
     • Added support for the isolation parameter in service definitions to specify container isolation mode
     • Added support for link-local IPs in the service networks definitions using the link_local_ips field

     +5 more show less

     • Added support for shell-style inline defaults in variable interpolation: ${FOO-default} and ${FOO:-default}
     • Added support for the group_add parameter in service definitions to add supplementary groups
     • Added support for the oom_score_adj parameter in service definitions to adjust OOMOOMAn out-of-memory condition: a program requests more memory than the system or device can provide. The allocation fails or the operating system may stop the process. score
     • Added support for the internal parameter in network definitions to create internal-only networks
     • Added support for the enable_ipv6 parameter in network definitions to enable IPv6IPv6The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. networking

     10 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Volume paths are no longer converted from C:\Users to /c/Users-style by default on Docker Toolbox/Machine; set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1 to restore previous behavior
108. 1.8.0 Jul 27, 2016 · release notes

     Docker Compose 1.8.0 adds bundle, push, and COMPOSE_TLS_VERSION env var.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.8.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.8.0

     └──▷ USE IT
     Generate a bundle file for deployment with Docker Stack
     shell copy

     docker-compose bundle

     Push all service images to their configured registries
     shell copy

     docker-compose push

     Force the use of TLS 1.2 when interacting with the Docker Engine
     shell copy

     COMPOSE_TLS_VERSION=TLSv1_2 docker-compose up

     • docker-compose bundle command that generates a bundle file for Docker Stack
     • docker-compose push command to push service images to a registry
     • COMPOSE_TLS_VERSION environment variable to specify TLS version for Docker Engine interaction

     3 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !docker-compose rm now removes containers created by docker-compose run by default
     • !Setting entrypoint on a service empties out any default command set on the image (i.e. CMD) to match docker run --entrypoint behavior
109. 1.7.0 Apr 13, 2016 · release notes

     Docker Compose 1.7.0 adds .env loading, docker-compose exec, TLS flags, and parallel start

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.7.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.7.0

     • docker-compose exec command for executing a process in a running container
     • Added --remove-orphans flag to both docker-compose up and docker-compose down to remove containers for services that were removed from the Compose file
     • .env file loading from the directory where it's run for environment variable defaults
     • Added support for all the same TLS configuration flags used by the docker client: --tls, --tlscert, --tlskey, etc.
     • COMPOSE_FILE environment variable can now contain multiple files, separated by the host system's standard path separator (: on Mac/Linux, ; on Windows)

     +4 more show less

     • Added --follow, --timestamp, and --tail flags to the docker-compose logs command
     • Added the --workdir flag to docker-compose run
     • docker-compose up, and docker-compose start will now start containers in parallel where possible
     • Compose files now support the tmpfs and shm_size options

     9 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !docker-compose logs no longer follows log output by default. Use -f to get the old default behaviour.
     • !Booleans are no longer allows as values for mappings in the Compose file (for keys environment, labels and extra_hosts). Boolean values should be quoted so they become string values.
110. 1.6.1 Feb 23, 2016 · release notes

     Docker Compose 1.6.1 adds network.aliases and improves volume/affinity behavior.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.6.1 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.6.1

     • Adds support for the network.aliases config key in the Compose file to set network-scoped aliases for services
     • Improves compatibility with Swarm by limiting container affinity to anonymous volumes only

     2 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Requires Docker Engine 1.9.1 or later, or 1.10.0 if using version 2 of the Compose File format
111. 1.6.0 Feb 4, 2016 · release notes

     Docker Compose 1.6 adds docker-compose events, config, create, down commands and network/volume definitions in Compose V2 format

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.6.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.6.0

     └──▷ USE IT
     Monitor container lifecycle events in real-time
     shell copy

     docker-compose events

     Validate and print the merged, variable-resolved Compose configuration without starting anything
     shell copy

     docker-compose config

     Pass build arguments in a Compose V2 file
     config copy

     build:
       context: .
       args:
         buildno: 1

     • docker-compose events command for monitoring container events
     • Compose file V2 introduces networks and volumes top-level keys alongside services
     • Build-time context args are now supported under the build key in Compose V2 format
     • docker-compose create creates containers without starting them
     • New --abort-on-container-exit flag for the up command

     +3 more show less

     • Support for cpu_quota configuration option in Compose files
     • Support for stop_signal configuration option in Compose files
     • depends_on option enforces startup order between services

     8 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Removed experimental flags --x-networking and --x-network-driver
     • !Compose 1.6 requires Docker Engine 1.9.1+ or 1.10.0 for Compose File format V2
     • !Removed support for FIG_FILE, FIG_PROJECT_NAME environment variables
     • !No longer reads fig.yml as a default Compose file location
112. 1.5.2 Dec 4, 2015 · release notes

     Docker Compose 1.5.2 allows specifying a URL for the build context.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.5.2 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.5.2

     • Add support for using a url as the value of build
     • Improved the validation of the expose option

     2 details in Everything

113. 1.5.1 Nov 12, 2015 · release notes

     Docker Compose 1.5.1 adds --force-rm to build and ulimit support in compose files

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.5.1 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.5.1

     • Adds --force-rm option to docker-compose build to force removal of intermediate containers on failure
     • Adds ulimit configuration option for services within the Compose file
     • Allows dashes (-) in keys under the environment service option in Compose files

     3 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !The name option is no longer accepted as a valid service option in Compose files (previously it silently overrode the actual service name)
114. 1.5.0 Nov 3, 2015 · release notes

     Docker Compose 1.5.0 adds host-side env var substitution, Windows support, multi-file overrides, named volumes, and pause/unpause commands.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.5.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.5.0

     └──▷ TRY IT
     Mount a named host volume by name instead of a path bind in the Compose file.
     copy

     $ volumes:
       - mydatavolume:/data

     • Environment variables are now interpolated on the host in the Compose file ($VAR or ${VAR}), requiring $$ escaping for literal passes to containers
     • The ipc config key is now supported in docker-compose.yml to specify an IPCIPCInter-process communication, ways for separate programs to exchange data or signals. Examples include pipes, sockets and shared memory. namespace
     • volumes_from accepts a mode suffix (e.g., servicename:ro) to mount volumes read-only
     • Named host volumes can be referenced in the volumes list by name (e.g., mydatavolume:/data), enabling named volume mounts instead of only path-based binds
     • docker-compose build --pull instructs Compose to pull the base image for each Dockerfile before building

     +6 more show less

     • docker-compose pull --ignore-pull-failures continues pulling if a single service's image fails, rather than aborting
     • Containers created by docker-compose run can be named using the --name flag
     • docker-compose run now supports a -p|--publish parameter for publishing specific ports to the host
     • docker-compose pause and docker-compose unpause commands are implemented analogously to docker pause/unpause
     • The extends directive now allows omitting the file option when copying configuration from another service in the same Compose file
     • Compose is now available for Windows via Docker Toolbox or binary download

     11 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Environment variable interpolation changed from container-side to host-side: values like $VAR or ${VAR} in command: or entrypoint: fields will be replaced by host environment variables instead of remaining literal for the container; migrate by escaping with $$ (e.g., $$VAR) if a literal dollar sign is needed.
     • !Compose 1.5.0 requires Docker 1.7.1 or later; versions prior to 1.7.1 are no longer supported.
115. 1.4.0 Aug 11, 2015 · release notes

     Docker Compose 1.4.0 adds smart recreate default, custom container names, stdin configs, volume driver/log options, and parallel execution.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.4.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.4.0

     └──▷ TRY IT
     Force a full recreation of all containers ignoring configuration changes
     copy

     $ docker-compose up --force-recreate

     Inject YAML configuration dynamically from stdout without a file
     copy

     $ echo 'redis: {image: redis}' | docker-compose --file - up

     • Adds --force-recreate flag to force full recreation when the previous --x-smart-recreate was removed
     • Removes experimental --x-smart-recreate flag which previously enabled selective container recreation
     • Adds container_name field to service definitions for specifying custom container names
     • Allows extends directive to omit the file option, defaulting to the current composition file
     • Extends service name validation to include dots, dashes, and underscores

     +6 more show less

     • Enables reading YAML configuration from standard input by passing - as the filename argument
     • Adds docker-compose version command for displaying bundled dependency information
     • Adds log_opt field in docker-compose.yml to pass extra options to logging drivers
     • Adds memswap_limit field in docker-compose.yml similar to --memory-swap in Docker
     • Allows passing any volume mode (e.g., :z, :Z) when mounting volumes, not just :ro or :rw
     • Adds volume_driver option in docker-compose.yml to specify custom volume drivers

     11 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !The --allow-insecure-ssl flag is deprecated and has no effect; plain HTTP image pulling now works by default
116. 1.3.0 Jun 18, 2015 · release notes

     Docker Compose 1.3.0 adds experimental smart recreate, new compose.yml config keys, and project root auto-discovery

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.3.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.3.0

     └──▷ TRY IT
     Test the new smart recreate behavior that only updates services with configuration changes
     copy

     $ docker-compose up --x-smart-recreate

     • Adds --x-smart-recreate flag to docker-compose up for experimental configuration-delta-aware container recreation
     • Adds dockerfile, labels, extra_hosts, pid, cpuset, read_only, security_opt, and log_driver configuration keys to docker-compose.yml
     • Enables automatic project root discovery by climbing parent directories to find docker-compose.yml

     3 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Compose now requires Docker 1.6.0 or later; installations with older Docker versions will fail
     • !Existing containers must be removed or migrated before running your app due to changes in container tracking (labels vs names) and recreation logic
117. 1.2.0 Apr 16, 2015 · release notes

     Docker Compose 1.2.0 adds extends for cross-file service inheritance, new CLI flags, and Swarm scheduling fixes

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.2.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.2.0

     └──▷ USE IT
     Run a command as a specific user
     shell copy

     docker-compose run --user 1000:1000 myservice /bin/bash

     • Adds extends option in docker-compose.yml to let a service inherit configuration from another service in a different configuration file
     • Adds --user flag to docker-compose run to specify the user for the command
     • Adds --timeout (-t) flag to up, stop, and restart commands to control graceful stop waiting period
     • Adds -f shorthand for --force on docker-compose rm
     • Enables net: container:<service> syntax to share another service's network namespace

     +1 more show less

     • Implements co-scheduling of dependent containers on the same Swarm node

     6 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Paths in build, env_file, and volumes are now resolved relative to the configuration file directory, not the working directory
118. 1.1.0 Feb 25, 2015 · release notes

     Docker Compose 1.1.0 adds fig rename, --service-ports, external_links, and env_file.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.1.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.1.0

     • Introduces docker-compose as the primary command (renamed from fig).
     • Adds --service-ports flag to docker-compose run for exposing service ports.
     • Adds external_links option to docker-compose.yml for linking to external containers.
     • Adds --no-build option to docker-compose up to skip automatic image building.
     • Makes Compose default to the latest tag when the image key lacks a specific tag.

     +3 more show less

     • Adds -s flag to docker-compose kill for sending specific signals to containers.
     • Adds env_file key to docker-compose.yml for loading environment variables from files.
     • Supports dns_search, cap_add, cap_drop, cpu_shares, and restart options in docker-compose.yml.

     8 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !The fig.yml config file must be renamed to docker-compose.yml.
     • !PyPi package name changed from fig to docker-compose.
119. 1.0.1 Nov 5, 2014 · release notes

     Adds --allow-insecure-ssl flag to fig up/run/pull commands

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.0.1 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.0.1

     └──▷ USE IT
     Pull images from a registry using self-signed certificates without errors
     shell copy

     fig pull --allow-insecure-ssl myimage:latest

     Run a container from an insecure registry
     shell copy

     fig run --allow-insecure-ssl myservice

120. 1.0.0 Oct 16, 2014 · release notes

     Docker Compose 1.0.0 adds new subcommands, TLS support, and advanced volume/config capabilities

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 1.0.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 1.0.0

     └──▷ USE IT
     Retrieve the mapped host port for a specific service without parsing verbose docker inspect output.
     shell copy

     fig port web-server 80

     Connect to the Docker daemon securely using client certificates and environment variables.
     shell copy

     export DOCKER_TLS_VERIFY=1 DOCKER_CERT_PATH=~/.docker/certs; fig up -d

     Run an interactive shell in a service with custom environment variables and entrypoint override.
     shell copy

     fig run --env MY_VAR=value --entrypoint=/bin/bash worker

     • Adds the fig port command to output host port bindings for a service
     • Adds the fig pull command to pull latest images for a service
     • Adds the fig restart command to restart a service's containers
     • Enables TLS daemon connection via DOCKER_CERT_PATH and DOCKER_TLS_VERIFY environment variables
     • Adds ro mode support, tilde expansion, and environment variable expansion to volume definitions

     +2 more show less

     • Allows setting the project name via the FIG_PROJECT_NAME environment variable
     • Adds --env and --entrypoint options to the fig run subcommand

     7 details in Everything

121. 0.5.2 Jul 31, 2014 · release notes

     Docker Compose 0.5.2 adds --no-cache flag to bypass build cache.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 0.5.2 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 0.5.2

     └──▷ USE IT
     Force a fresh build for an image, ignoring any cached layers.
     shell copy

     fig build --no-cache

122. 0.5.0 Jul 11, 2014 · release notes

     Docker Compose 0.5.0 adds env variable resolution, volumes_from support and automatic link starting to fig.yml.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 0.5.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 0.5.0

     • Adds volumes_from directive in fig.yml to mount volumes from other services or containers
     • Adds blank value syntax (e.g. SESSION_SECRET:) in environment section of fig.yml to resolve variables from the host environment
     • Makes fig run and fig up automatically start linked services based on dependencies

     3 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !The hostname option in fig.yml is now split into a domainname option
123. 0.4.1 May 8, 2014 · release notes

     Docker Compose 0.4.1 adds configurable project name support

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 0.4.1 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 0.4.1

     • Adds name configuration option to make the project name configurable

     1 detail in Everything

124. 0.4.0 Apr 30, 2014 · release notes

     Fig adds privileged config option and updates container stop behavior in v0.4.0

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 0.4.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 0.4.0

     • fig.yml now supports the privileged configuration key to grant containers elevated privileges.

     1 detail in Everything

     └──▷ BREAKING ON UPGRADE

     • !Docker 0.8 is no longer supported; you must upgrade to Docker 0.9 or 0.10+.
125. 0.3.0 Mar 3, 2014 · release notes

     Docker Compose 0.3.0 adds OS X/Linux binaries and -f flag to specify alternate fig.yml files

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch 0.3.0 https://github.com/docker/compose.git
     # already have the repo? check out this version:
     $ git checkout 0.3.0