instruction: Explain Release notes
output: Back
  Ask AI
  Start typing to search or try
  Contact support
  Manuals
  Get started
  Guides
  Docker Compose release notes
  Page options
  Copy page as Markdown for LLMs
  View page as plain text
  Ask questions with Docs AI
  Claude
  Open in Claude
  For more detailed information, see the
  release notes in the Compose repo
  Bug fixes and enhancements
  Fixed multiple rendering issues with the build output
  Fixed issue when
  pull
  no_cache
  attributes were not applied with
  bake
  Removed log display of explicitly un-attached services on
  command
  Update
  Dependencies upgrade: bump docker engine and cli to v28.3.3
  Dependencies upgrade: bump golang to v1.23.12
  Dependencies upgrade: bump containerd to 2.1.4
  Bug fixes and enhancements
  Added metrics to monitor
  models
  usage
  Update
  Dependencies upgrade: bump compose-go to v2.8.1
  Bug fixes and enhancements
  Added
  --models
  flag to
  config
  command to list models
  Added
  --since
  --until
  flags to
  events
  Introduced
  provenance
  sbom
  attributes to
  build
  section
  Fixed
  bridge convert
  issue on Windows
  Fixed multiple issues with
  bake
  builds
  Update
  Dependencies upgrade: bump docker engine and cli to v28.3.2
  Dependencies upgrade: bump buildx to v0.26.1
  Dependencies upgrade: bump compose-go to v2.8.0
  Bug fixes and enhancements
  Added
  --networks
  flag to
  config
  command to list networks
  Fixed an issue on
  down
  command with Docker Model Runner used as a provider service
  Fixed a display issue on Docker Model Runner progress
  Fixed an issue with services with profile missing secrets
  Update
  Dependencies upgrade: bump docker engine and cli to v28.3.1
  Dependencies upgrade: bump buildkit to v0.23.2
  Dependencies upgrade: bump golang to v1.23.10
  Bug fixes and enhancements
  Added support of
  model_variable
  for service
  models
  configuration
  Update
  Dependencies upgrade: bump compose-go to v2.7.1
  Bug fixes and enhancements
  Introduced support of
  models
  for LLM configuration
  Added
  volumes
  command
  Removed
  publish
  limitation on bind mounts
  Fixed an issue mounting the docker socket to container which doesn't need it
  Fixed an issue with bake hanging on output
  Update
  Dependencies upgrade: bump compose-go to v2.7.0
  Dependencies upgrade: bump docker engine and cli to v28.3.0
  Bug fixes and enhancements
  Added support of
  cache_to
  for Bake
  Fixed issue with Bake integration
  Fixed multiple issues affecting
  command
  Update
  Dependencies upgrade: bump buildkit to v0.23.1
  Bug fixes and enhancements
  Introduce
  use_api_socket
  Fixed
  compose images
  JSON output format
  Fixed panic using
  shortcut on project without watch support
  Fixed a permission issue with bake metadata files on Windows
  Fixed a panic error on provider service startup
  Update
  Dependencies upgrade: bump compose-go to v2.6.5
  Dependencies upgrade: bump buildx to v0.25.0
  Dependencies upgrade: bump buildkit to v0.23.0
  Bug fixes and enhancements
  Fixed a permission issue with bake metadata files on Windows
  Fixed a panic error on provider service startup
  Reverted
  compose images
  JSON output to array format
  Bug fixes and enhancements
  Fixed an issue with random port allocation
  Fixed an issue recreating containers when not needed during inner loop
  Fixed a problem during
  up --build
  with
  additional_context
  Update
  Dependencies upgrade: bump compose-go to v2.6.4
  Dependencies upgrade: bump buildx to v0.24.0
  Dependencies upgrade: bump buildkit to v0.22.0
  Bug fixes and enhancements
  Compose Bridge features are now part of Compose
  Improved display of the
  docker compose images
  command
  Promoted
  bake
  as the default build tool for Compose
  Fixed issues around build flow
  Fixed the restart of dependent services after
  watch
  rebuild images
  Update
  Dependencies upgrade: bump docker engine and cli to v28.2.2
  Bug fixes and enhancements
  Introduced support of arrays for
  provider
  service
  options
  attribute
  Added
  debug
  messages in the extension protocol
  Fixed an issue when trying to publish a Compose application with a
  provider
  service
  Fixed build issues on Compose applications with
  service.provider
  Introduced
  --lock-image-digests
  config
  command
  Update
  Dependencies upgrade: bump compose-go to v2.6.3
  Dependencies upgrade: bump containerd to 2.1.0
  Bug fixes and enhancements
  Introduced
  networks.interface_name
  Added support for
  COMPOSE_PROGRESS
  env variable
  Added
  service.provider
  to external binaries
  Introduced build
  --check
  flag
  Fixed multiple panic issues when parsing Compose files
  Update
  Dependencies upgrade: bump compose-go to v2.6.2
  Dependencies upgrade: bump docker engine and cli to v28.1.0
  Dependencies upgrade: bump containerd to 2.0.5
  Dependencies upgrade: bump buildkit to v0.21.1
  Bug fixes and enhancements
  Fixed an issue with bind mounts
  Update
  Dependencies upgrade: bump compose-go to v2.6.0
  Dependencies upgrade: bump docker engine and cli to v28.0.4
  Dependencies upgrade: bump buildx to v0.22.0
  Bug fixes and enhancements
  Added support for
  Docker Model Runner
  to easily integrate AI models into your Compose applications
  Added
  build --print
  command to help debug complex build configurations by showing the equivalent bake file
  Added
  volume.type=image
  to provide more flexible volume management for container images
  Added
  --quiet
  options to the
  command for cleaner output when running containers
  Added
  config --no-env-resolution
  option to view raw configuration without environment variable substitution
  Fixed behavior of
  depends_on
  to prevent unnecessary container recreation when dependencies change
  Fixed support for secrets defined by environment variables when using
  include
  Fixed volume mount handling to ensure bind mounts work correctly in all scenarios
  Update
  Dependencies upgrade: bump docker engine and cli to v28.1.0
  Dependencies upgrade: bump buildx to v0.23.0
  Dependencies upgrade: bump buildkit to v0.21.0
  Bug fixes and enhancements
  Added support of refresh
  pull_policy
  values
  daily
  weekly
  every_<duration>
  Introduced
  include
  attribut to
  watch
  definition to match file patterns
  Introduced
  --env-from-file
  in flag for the
  docker compose run
  command
  Promoted
  publish
  as a regular command of Compose
  Fixed a bug by loading
  env_file
  after services have been selected
  Update
  Dependencies upgrade: bump docker engine and cli to v28.0.1
  Dependencies upgrade: bump buildkit to v0.17.1
  Dependencies upgrade: Bump compose-go v2.4.9
  Dependencies upgrade: Bump buildx v0.21.2
  Bug fixes and enhancements
  Added support for
  gw_priority
  enable_ipv4
  (requires Docker v28.0)
  Fixed an issue with the navigation menu
  Improved error message when using non-file secret/config with read-only service
  Update
  Dependencies upgrade: bump docker engine and cli to v28.0.0
  Bug fixes and enhancements
  Introduced a hint to promote the use of
  Bake
  Introduced support for the
  additional_context
  attribute referencing another service
  Added support for
  BUILDKIT_PROGRESS
  Compose now warns you when a published Compose application includes environment variables
  Added a
  --with-env
  flag to publish a Compose application with environment variables
  Updated
  ls --quiet
  help description
  Fixed multiple issues delegating build to Bake
  Updated help in
  stats
  command
  Fixed support for "builtin" seccomp profile
  Fixed support for
  watch
  with multiple services
  Removed exit code per error type used by legacy metrics system
  Fixed test coverage for
  compatibility
  Removed raw os.Args sent to OpenTelemetry
  Enabled copyloopvar linter
  Fixed provenance for binaries and generate SBOM
  Main branch for docs upstream validation is now used
  Added codeowners file
  Added Docker Engine v28.x to the test-matrix
  Update
  Dependencies upgrade: Bump compose-go v2.4.8
  Dependencies upgrade: Bump buildx v0.20.1
  Dependencies upgrade: Bump docker to v27.5.1
  Dependencies upgrade: Bump golangci-lint to v1.63.4
  Dependencies upgrade: Bump golang.org/x/sys from 0.28.0 to 0.30.0
  Dependencies upgrade: Bump github.com/moby/term v0.5.2
  Dependencies upgrade: Bump github.com/otiai10/copy from 1.14.0 to 1.14.1
  Dependencies upgrade: Bump github.com/jonboulle/clockwork from 0.4.0 to 0.5.0
  Dependencies upgrade: Bump github.com/spf13/pflag from 1.0.5 to 1.0.6
  Dependencies upgrade: Bump golang.org/x/sync from 0.10.0 to 0.11.0
  Dependencies upgrade: Bump gotest.tools/v3 from 3.5.1 to 3.5.2
  Bug fixes and enhancements
  Fixed an issue where the Compose version did not display properly when using
  docker compose version
  Note
  Binaries from the Compose GitHub repository may not display the version number properly. If you rely on
  docker compose version
  in your development or CI processes, upgrade to Compose version 2.32.4.
  Bug fixes and enhancements
  Fixed an issue where Compose would override a service-level MAC address with the main network MAC address
  Fixed a log rendering issue during concurrent builds
  Update
  Dependencies upgrade: bump compose-go to v2.4.7
  Dependencies upgrade: bump golang to v1.22.10
  Bug fixes and enhancements
  Added
  --pull
  flag to the
  docker compose run
  command
  Fixed a bug which meant the
  restart
  action of
  watch
  mode didn't monitor bind mounts
  Fixed an issue recreating containers when using anonymous volumes
  Bug fixes and enhancements
  Fixed a bug recreating containers when not needed
  Update
  Dependencies upgrade: bump docker + buildx to latest release
  Dependencies upgrade: bump otel dependencies to v1.28.0 and v0.53.0
  Dependencies upgrade: bump golang.org/x/sys 0.28.0
  Dependencies upgrade: bump golang.org/x/crypto to 0.31.0
  Dependencies upgrade: bump google.golang.org/grpc to 1.68.1
  Dependencies upgrade: bump golang.org/x/sync 0.10.0
  Dependencies upgrade: bump xx to v1.6.1
  Bug fixes and enhancements
  Improved support when building with
  Bake
  Added
  restart
  sync+exec
  watch actions
  Compose now recreates containers when the volume or network configuration changes
  Fixed support for
  mac_address
  Fixed
  pull --quiet
  to only hide progress, not global status
  Fixed an issue where only the
  rebuild
  watch action now requires a build declaration
  Compose now logs
  watch
  configuration error when enabled through the Compose menu
  Update
  Dependencies upgrade: bump compose-go to v2.4.5
  Dependencies upgrade: bump docker engine and cli to v27.4.0-rc.2
  Dependencies upgrade: bump buildx to v0.18.0
  Dependencies upgrade: bump buildkit to v0.17.1
  Bug fixes and enhancements
  Added the ability to use Docker Buildx Bake to build Docker Compose services
  Added
  commit
  command to create new images from running containers
  Fixed an issue where network changes were not detected
  Fixed an issue where containers stopped sequentially which slowed down the restart process
  Update
  Dependencies upgrade: bump compose-go to v2.4.4
  Bug fixes and enhancements
  Fixed an issue re-starting services that should not when using
  --watch
  Improve the fix of using same YAML anchor multiple times in a Compose file
  Update
  Dependencies upgrade: bump compose-go to v2.4.3
  Bug fixes and enhancements
  Fixed an issue re-creating services when updating its profiles
  Fixed a regression when using the same YAML anchor multiple times in a Compose file
  Update
  Dependencies upgrade: bump compose-go to v2.4.2
  Bug fixes and enhancements
  Fixed a regression when using stdin as input for
  flag
  Fixed a regression when using the same YAML anchor multiple times in a Compose file
  Update
  Dependencies upgrade: bump compose-go to v2.4.1
  Dependencies upgrade: bump docker engine and cli to v27.3.1
  Bug fixes and enhancements
  Introduction of service hooks support.
  Addition of alpha
  generate
  command.
  Addition of
  export
  command.
  Added support for CDI device requests using
  devices
  in the Compose file.
  A lot a bug fixes.
  Bug fixes and enhancements
  Fixed a regression when using mount API for bind mounts.
  Update
  Dependencies upgrade: bump docker engine and cli to v27.3.0-rc.2
  Bug fixes and enhancements
  Fixed an issue with Windows Containers bind mounts.
  Bug fixes and enhancements
  Fixed an issue with bind mounts on WSL2.
  Update
  Dependencies upgrade: bump buildx to v0.17.1
  Dependencies upgrade: bump docker engine and cli to v27.3.0-rc.1
  Bug fixes and enhancements
  Fixed an issue with services not stopping when restarting diverged dependencies.
  Fixed potential
  pointer error on the OTEL client.
  Update
  Dependencies upgrade: bump compose-go to v2.2.0
  Dependencies upgrade: bump docker engine and cli to v27.2.1
  Bug fixes and enhancements
  Combination of bind mount and
  rebuild
  are now allowed with
  watch
  Fixed a bug recreating containers when
  --no-deps
  is used with
  Fixed a bug not closing streams when reattaching containers.
  Restored recreation of anonymous volumes when using
  --renew-anon-volumes
  Update
  Dependencies upgrade: bump compose-go to v2.1.6
  Dependencies upgrade: bump docker engine and cli to v27.1.2
  Dependencies upgrade: bump buildx to v0.16.2
  Dependencies upgrade: bump buildkit to v0.15.2
  Dependencies upgrade: bump golang to v1.21.12
  Dependencies upgrade: bump sys to v0.22.0
  Dependencies upgrade: bump flock to v0.12.1
  Bug fixes and enhancements
  Fixed the docs on
  docker compose kill
  usage.
  Fixed redundant condition from
  toAPIBuildOptions
  in build.go.
  Fixed initial Watch
  sync
  after Compose restarts with introduction of
  x-initialSync
  Fixed an issue which stopped the Compose process for a single container on
  sync-restart
  Watch action.
  Update
  Dependencies upgrade: bump compose-go to v2.1.5.
  Dependencies upgrade: bump docker engine and cli to v27.1.0.
  Bug fixes and enhancements
  Enhance JSON progress events with more fields.
  Update
  Dependencies upgrade: bump compose-go to v2.1.4
  Dependencies upgrade: bump docker engine and cli to v27.0.3
  Dependencies upgrade: bump buildx to 0.16.0
  Dependencies upgrade: bump buildkit to 0.15.0
  Dependencies upgrade: bump containerd to 1.7.19
  Bug fixes and enhancements
  Added a JSON stream progress writer.
  Added a
  --prune
  flag to the
  docker compose watch
  command.
  Unnecessary resources are now excluded after services have been selected.
  Empty variables with no value are unset in containers.
  Bug fixes and enhancements
  Fixed progress display, broken in
  v2.28.0
  , when TTY mode available.
  Update
  Dependencies upgrade: bump compose-go to v2.1.3
  Dependencies upgrade: bump docker engine and cli to v27.0.1-rc.1
  Update
  Dependencies upgrade: bump buildx to 0.15.1
  Dependencies upgrade: bump buildkit to 0.14.1
  Update
  Dependencies upgrade: bump golang to 1.21.11
  Dependencies upgrade: bump docker engine and cli to v26.1.4
  Dependencies upgrade: bump buildx to 0.15.0
  Dependencies upgrade: bump buildkit to 0.14.0
  Dependencies upgrade: bump containerd to 1.7.18
  Bug fixes and enhancements
  Added an
  --environment
  flag to the
  config
  command
  Fixed a bug which caused the
  watch
  process to hang when used as flag with the
  command
  Fixed usage of
  COMPOSE_PROFILES
  .env
  file
  Update
  Dependencies upgrade: bump compose-go to v2.1.1
  Dependencies upgrade: bump docker engine and cli to v26.1.3
  Dependencies upgrade: bump buildx to 0.14.1
  Dependencies upgrade: bump containerd to 1.7.17
  Bug fixes and enhancements
  Added a navigation menu in the CLI where you can open your Compose file in Docker Desktop
  Added documentation for
  --menu
  flag in
  docker compose up
  Fixed a bug with
  --resolve-image-digests
  used with
  --no-interpolate
  You can now use a local
  .env
  file to override
  COMPOSE_*
  environment variables
  Update
  Dependencies upgrade: bump golang to 1.21.9
  Dependencies upgrade: bump compose-go to v2.1.0
  Dependencies upgrade: bump docker engine and cli to v26.1.0
  Bug fixes and enhancements
  Introduced
  --abort-on-container-failure
  flag
  Introduced
  --all-resources
  to not exclude resources not used by services
  Introduced support for
  build.entitlements
  Fixed a bug so Docker Compose now ignores missing containers when
  docker compose down/stop -p
  is run
  Fixed support for
  --flag=value
  syntax in compatibility mode
  Update
  Dependencies upgrade: opencontainers/image-spec v1.1.0
  Bug fixes and enhancements
  Added image pull failure reason in output
  Fixed crash when running up with
  --no-build
  --watch
  Fixed crash when no TTY available and menu enabled
  Improved legibility of menu actions
  Update
  Dependencies upgrade: bump compose-go v2.0.2
  Dependencies upgrade: bump docker v26.0.0
  Bug fixes and enhancements
  Reduced timeout of the Otel tracing command
  Fixed
  config --format json
  Fixed documentation on default build image name
  Introduced Synchronized file shares for bind mounts in Compose
  Added support for
  annotations
  Introduced
  config --variables
  to list Compose model variables
  Added a navigation menu within
  docker compose up
  Update
  Dependencies upgrade: bump compose-go v2.0.0
  Bug fixes and enhancements
  Restored
  config
  behaviour until
  --no-interpolate
  is set
  Fixed service name shell completion
  Added
  --watch
  flag to
  command
  Update
  Dependencies upgrade: bump golang to 1.21.8
  Dependencies upgrade: bump compose-go to 2.0.0-rc8
  Dependencies upgrade: bump docker to v24.0.4
  Bug fixes and enhancements
  Compose now ensures stable priority sort order for networks
  Fixed interpolation with curly braces (e.g. JSON) in default values
  Fixed validation for non-unique
  container_name
  values
  Fixed validation for
  develop.watch
  Fixed environment loading for
  include
  Fixed panic when merging labels/networks
  Added support for
  --no-path-resolution
  when using
  include
  Fixed missing project name errors
  Fixed
  --no-interpolate
  flag on
  config
  Added a workaround for file lock issues with Watch mode on Windows
  Fixed duplicate exit code status messages
  Compose now respects
  COMPOSE_REMOVE_ORPHANS
  Update
  Dependencies upgrade: bump cli to 25.0.3
  Dependencies upgrade: bump compose-go to 2.0.0-rc.7
  Bug fixes and enhancements
  Fixed issue of
  .env
  file loading when project file is set via
  COMPOSE_FILE
  variable
  Aligned
  ps --status=exited
  behaviour with the Docker CLI behaviour
  Fixed a deadlock when collecting large logs
  Bug fixes and enhancements
  Fixed "failed to solve: changes out of order" errors when building images on Windows.
  Update
  Dependencies upgrade: bump cli to 25.0.1
  Dependencies upgrade: bump docker to 25.0.1
  Dependencies upgrade: bump compose-go to 2.0.0-rc.3
  Bug fixes and enhancements
  Fixed issue when checking external network existence when swarm is enabled.
  Added support for
  storage_opt
  attribute.
  This release fixes a build issue with Docker Desktop for Windows introduced in Compose v2.24.0.
  Update
  Compose now uses a custom version of
  fsutils
  library.
  Update
  Dependencies upgrade: bump cli to 25.0.0 GA
  Dependencies upgrade: bump compose-go to 2.0.0-rc.2
  Update
  Dependencies upgrade: bump cli to 25.0.0-rc3
  Dependencies upgrade: bump docker to 25.0.0-rc3
  Dependencies upgrade: bump compose-go to 2.0.0-rc.1
  Dependencies upgrade: bump containerd to 1.7.12
  Bug fixes and enhancements
  Reworked the display of container status during
  Fixed the engine version required to use
  healthcheck.start_interval
  Removed
  watch
  subcommand from the
  alpha
  command
  Fixed a bug when handling received signals
  Update
  Dependencies upgrade: bump cli to 25.0.0-beta.3
  Dependencies upgrade: bump compose-go to 2.0.0-beta.3
  Dependencies upgrade: bump golang to 1.21.6
  Bug fixes and enhancements
  Introduced
  docker compose attach
  to attach local standard input, output, and error streams to a service's running container.
  Introduced
  docker compose stats
  to display a live stream of container(s) resource usage statistics.
  Introduced
  docker compose ps --orphans
  to include/exclude services not declared.
  Introduced
  docker compose logs --index
  to select a replica container.
  Introduced
  docker compose build --with-dependencies
  to also build dependencies.
  Added source policies for build.
  Included disabled services for shell completion.
  Restored
  Project
  in ps JSON output.
  Added OCI 1.0 fallback support for AWS ECR.
  Build now does not require environment to be resolved.
  Compose now sends out a cancel event on SIGINT/SIGTERM signal for
  compose up
  Fixed log by exposing services ports when
  --verbose
  Fixed inlined and environment-defined configs to be mounted under /<id> until an explicit target is set.
  Fixed combination of
  --pull always --no-build
  Fixed race condition in log printer.
  Fixed
  docker compose up
  teardown when command context is cancelled.
  Update
  Dependencies upgrade: bump buildx to v0.12.0
  Update
  Dependencies upgrade: bump buildkit 0.12.3
  Dependencies upgrade: bump docker 24.0.7
  Dependencies upgrade: bump cli 24.0.7
  Dependencies upgrade: bump 1.20.2
  Bug fixes and enhancements
  Compose now supports
  builds.tags
  with
  push
  command.
  Compose Watch now re-builds service images at startup.
  --remove-orphans
  doesn't manage disabled services as orphaned.
  Compose displays
  Building
  output log only if there is at least one service to build.
  Update
  Dependencies upgrade: bump compose-go to v1.20.1
  Bug fixes and enhancements
  Aligned Compose with OCI artifact best practices.
  Introduced
  --resolve-image-digests
  so users can seal service images by digest when publishing a Compose application.
  Improved Compose Watch configuration logging.
  Compose now rejects a Compose file using
  secrets|configs.driver
  template_driver
  Compose now fails to start if a dependency is missing.
  Fixed SIGTERM support to stop/kill stack.
  Fixed a
  --hash
  regression.
  Fixed "Application failed to start after update" when an external network is on a watched service.
  Fixed
  --pull
  documentation.
  Fixed display by adding newline in cmd/compose/build.go.
  Compose is rendered quiet after filtering applied.
  Stripped project prefix from docker-compose up output.
  Update
  Dependencies upgrade: bump compose-go to v1.20.0
  Dependencies upgrade: bump containerd to 1.7.7
  Bug fixes and enhancements
  Added dry-run support for publish command
  Added
  COMPOSE_ENV_FILES
  env variable to pass a list of env files
  Added
  sync+restart
  action to
  compose watch
  Aligned
  compose ps
  output with Docker CLI by default and introduced
  --no-trunc
  to keep the previous behaviour
  Fixed hashes inconsistency between
  configure
  Enabled profiles when
  down
  ran with explicit service names
  Fixed an issue when the pull policy provided was invalid
  Note
  watch
  command is now generally available (GA). You can directly use it from the root command
  docker compose watch
  For more information, see
  File watch
  Update
  Dependencies upgrade: bump golang to 1.21.1
  Dependencies upgrade: bump compose-go to v1.19.0
  Dependencies upgrade: bump buildkit to v0.12.2
  Bug fixes and enhancements
  Added experimental support for the
  publish
  command.
  The command
  watch
  now builds and launches the project during startup.
  Added
  option to the
  --pull
  flag.
  Fixed various race and deadlock conditions for
  command on exit.
  Fixed multi-platform issues on build.
  Enabled services that are explicitly requested even when their
  profiles
  aren't activated.
  Fixed a
  config
  issue when the declared
  env_file
  is missing.
  Passed BuildOptions to
  commands.
  Note
  The format of
  docker compose ps
  docker compose ps --format=json
  changed to better align with
  docker ps
  output. See
  compose#10918
  Update
  Dependencies upgrade: bump compose-go to v1.18.3
  Bug fixes and enhancements
  Changed
  docker compose ps
  docker compose ps --format=json
  output to align with Docker CLI.
  Added support for multi-document YAML files.
  Added support for loading remote Compose files from Git repos with
  include
  (experimental).
  Fixed incorrect proxy variables during build.
  Fixed truncated container logs on container exit.
  Fixed "no such service" errors when using
  include
  with
  --profile
  Fixed
  .env
  overrides when using
  include
  Update
  Dependencies upgrade: bump golang to 1.21.0
  Dependencies upgrade: bump compose-go to v1.18.1
  Dependencies upgrade: bump buildkit to v0.12.1
  Bug fixes and enhancements
  Improved speed and reliability of
  watch
  sync.
  Added builder's name on the first build line.
  Improved shell completion for
  --project-directory
  --profile
  Fixed build issue with proxy configuration not passing to legacy builder.
  Removed unnecessary warning when an option dependency exists successfully.
  Bug fixes and enhancements
  Added support for the
  depends_on.required
  attribute.
  Fixed an issue where build tries to push unnamed service images.
  Fixed a bug which meant the target secret path on Windows was not checked.
  Fixed a bug resolving build context path for services using
  extends.file
  Update
  Dependencies upgrade: bump golang to 1.20.6
  Dependencies upgrade: bump buildx to v0.11.2
  Dependencies upgrade: bump buildkit to v0.12
  Dependencies upgrade: bump docker-cli to v24.0.5-dev
  Update
  Dependencies upgrade: bump docker/cli-docs-tools to v0.6.0
  Dependencies upgrade: bump docker to v24.0.4
  Dependencies upgrade: bump buildx to v0.11.1
  Bug fixes and enhancements
  Introduced the
  wait
  command.
  Added support of
  --builder
  BUILDX_BUILDER
  to the
  build
  command.
  Added support for the
  include
  attach
  attributes from the Compose Specification.
  Fixed a DryRun mode issue when initializing CLI client.
  Fixed a bug with random missing network when a service has more than one.
  Fixed the Secrets file permission value to comply with the Compose Specification.
  Fixed an issue about
  no-deps
  flag not being applied.
  Fixed some source code comments.
  Fixed a bug when
  --index
  is not set select.
  Fixed a process leak in the wait e2e test.
  Improved some test speeds.
  Update
  Dependencies upgrade: bump compose-go to v1.15.1
  Bug fixes and enhancements
  Fixed sporadic "container not connected to network" errors on
  compose up
  Fixed "please specify build context" errors on
  compose build
  Compose now warns if using a bind mount in a service
  watch
  configuration.
  Update
  Dependencies upgrade: bump compose-go to v1.15.0
  Dependencies upgrade: bump buildx to v0.11.0
  Dependencies upgrade: bump docker to v24.0.2
  Dependencies upgrade: bump golang to 1.20.5
  Bug fixes and enhancements
  Introduced the ability to select a single service to be stopped by
  compose down
  Added
  --progress
  as top-level flag to configure progress UI style.
  Introduced
  run --cap-add
  to run maintenance commands using service image.
  Fixed a bug during detection of swarm mode.
  Fixed a bug when setting the project name via
  COMPOSE_PROJECT_NAME
  environment variable.
  Adjusted the display of the volumes flag with the help of
  down
  command.
  Fixed a bug in the
  command which should not silently ignore missing
  depends_on
  services.
  Aligned forward signal to container behaviour with the
  docker run
  one.
  Compose now detects network name conflict.
  Fixed a typo in the warning message about an existing volume.
  Compose now detects new services started after
  compose -p x logs -f
  command.
  Fixed a bug when
  compose
  was used as project name.
  Fixed a bug in the
  watch
  command when a directory does not exist.
  Removed default timeout of 10 seconds when restarting or stopping services.
  Fixed a bug in
  watch
  which applied the "rebuild" strategy by default.
  Fixed a race condition, waiting for containers when one exit.
  Added a warning telling users that uid,gid,mode are not implemented for
  build.secrets
  Fixed a bug in
  watch
  which was watching the whole build context instead of only configured paths.
  Compose now sorts containers by creation date to scale down the older ones first.
  Fixed a bug in the docs generation task for Windows environments.
  Updated the docs to reflect Dry Run mode is feature complete.
  Improved the diagnostic message on network label mismatch.
  Fixed a bug which was rendering
  Building
  section when there was no build involved.
  Fixed a bug in code coverage metrics.
  Added OTEL initialization.
  Added a GitHub action to trigger Docker Desktop e2e tests with Compose edge versions.
  Added more ignore rules to dependabot.
  Bug fixes and enhancements
  Fixed "Image not found" errors when building images
  Update
  Dependencies upgrade: bump compose-go to v1.13.5
  Dependencies upgrade: bump buildkit to v0.11.6
  Dependencies upgrade: bump docker to v23.0.5
  Bug fixes and enhancements
  Added dry run support using
  --dry-run
  Added the first (alpha) implementation of the
  sub-command
  Introduced
  --no-path-resolution
  to skip relative path to be resolved
  Introduced
  COMPOSE_ANSI
  to define the
  --ansi
  default value
  Introduced
  COMPOSE_STATUS_STDOUT
  to get status messages sent to stdout
  Fixed the BuildKit progressui integration
  Fixed a bug to stop blocking the events loop collecting logs
  Restored support for
  --memory
  Fixed a bug which meant containers didn't stop after termination
  Compose now lets users declare the build secret target
  Fixed a bug which caused a container to be recreated when the config has not changed
  Fixed a race condition when
  --parallel
  is used with a large number of dependent services
  Compose now checks the local image matches the required platform
  Fixed local image removal when
  compose down
  is ran with
  --project-name
  Compose now detects the active endpoint trying to remove the network and skips with a warning
  Removed unnecessary [] output
  Compose detects that a Windows terminal is not a
  console.File
  to avoid a panic
  --parallel
  now has precedence over
  COMPOSE_PARALLEL_LIMIT
  Compose now reports that the external network is not found when Swarm is disabled
  Update
  Dependencies upgrade: bump compose-go to v1.13.2
  Bug fixes and enhancements
  Fixed invalid project name error for directories with uppercase characters or
  in the name. Fixed
  compose#10405
  Update
  Dependencies upgrade: bump buildkit to v0.11.5
  Dependencies upgrade: bump compose-go to v1.13.1
  Dependencies upgrade: bump golang to 1.20.2
  Bug fixes and enhancements
  Fixed panic on
  alpha watch
  command. Pull Request
  compose#10393
  Prevented conflicts for services named
  extensions
  . Fixed
  compose-go#247
  Compose now validates project names more consistently. Fixed
  compose-go#363
  Upgrade notes
  Project name validation is more strictly enforced. Project names can only include letters, numbers,
  and must be lowercase and start with a letter or number.
  Boolean fields in YAML must be either
  true
  false
  . Deprecated YAML 1.1 values such as "on" or "no" are not supported.
  Duplicate YAML merge keys (
  ) are rejected.
  Update
  Dependencies upgrade: bump buildkit to v0.11.4
  Dependencies upgrade: bump buildx to v0.10.4
  Dependencies upgrade: bump containerd to 1.6.18
  Dependencies upgrade: bump compose-go to v1.13.0
  Bug fixes and enhancements
  Introduced
  --wait-timeout
  command. Fixed
  compose#10269
  Made
  compose service --hash
  output sort by service name. Pull Request
  compose#10278
  Compose now renders a compact TUI progress report to monitor layers download. Pull Request
  compose#10281
  Introduced
  restart
  depends_on
  . Fixed
  compose#10284
  Added support of
  NO_COLOR
  env var. Fixed
  compose#10340
  Progress writer now uses
  dockercli.Err
  stream. Fixed
  compose#10366
  Added support for
  additional_contexts
  in the
  build
  service configuration. Fixed
  compose#9461
  compose#9961
  Added file delete/rename handling in
  watch
  mode. Pull Request
  compose#10386
  Introduced an
  ignore
  attribute in
  watch
  mode. Pull Request
  compose#10385
  Compose now uses progress writer to show copies status. Pull Request
  compose#10387
  Updated reference documentation for
  --project-name
  flag. Fixed
  docs#16915
  compose-spec#311
  Introduced a
  replace
  label to track the relationship between old and new containers of a service. Fixed
  compose#9600
  Fixed a bug that meant dependent services were not restarted after a service was restarted. Fixed
  compose#10263
  Compose now ignores services without a build section in
  watch
  mode. Fixed
  compose#10270
  Compose now applies config options for pseudo-subcommands. Fixed
  compose#10286
  Compose manages only containers with config_hash labels (i.e, created by compose). Fixed
  compose#10317
  Compose triggers an error if the project name is empty after normalization. Fixed
  compose#10313
  Compose restarts only needed services by checking
  depends_on
  relations. Fixed
  compose#10337
  Fixed a display issue on small terminals. Fixed
  compose#10322
  Fixed an issue with building the built images IDs collection. Pull Request
  compose#10372
  Use configured name separator to define oneoff container name. Fixed
  compose#10354
  Fixed concurrent map read/write issue when recreating containers. Fixed
  compose#10319
  Compose now supports Dry Run mode for
  stop
  commands. Pull Request
  compose#10257
  Compose now supports Dry Run mode for
  pull
  command. Pull Request
  compose#10341
  Compose now supports Dry Run mode for
  push
  command. Pull Request
  compose#10355
  Compose now supports Dry Run mode for
  exec
  command. Pull Request
  compose#10252
  Compose now supports Dry Run mode for
  restart
  command. Pull Request
  compose#10339
  Update
  Dependencies upgrade: bump docker to v23.0.0
  Dependencies upgrade: bump docker-cli to v23.0.0
  Dependencies upgrade: bump buildkit to v0.11.2
  Dependencies upgrade: bump buildx to v0.10.2
  Dependencies upgrade: bump containerd to 1.6.16
  Dependencies upgrade: bump golang to 1.20
  Bug fixes and enhancements
  Introduced
  --remove-orphans
  for the
  compose create
  command. Fixed
  compose#9718
  Shortened the TTY output when the terminal is too small. Fixed
  compose#9962
  Added
  remove-orphans
  functionality to run. Fixed
  compose#9718
  Introduced the experimental
  watch
  command. Pull Request
  compose#10163
  Compose now allows TTY to be allocated with
  . Fixed
  compose#10161
  Introduced the experimental
  dry-run
  command. Pull Request
  compose#10173
  Updated the documentation to explain ways to configure parallelism. Pull Request
  compose#10198
  Aligned the
  logs
  command with docker CLI by aliasing
  --tail
  . Fixed
  compose#10199
  Added support for
  docker compose build --push
  . Pull Request
  compose#10148
  Added
  --scale
  to the
  compose create
  command. Fixed
  compose#10208
  Renamed
  convert
  config
  to align with the Compose V1 UX. Pull Request
  compose#10214
  Compose now passes the proxy config as build args. Fixed
  compose#8797
  Fixed parsing issue in
  compose up
  by ignoring containers not created by Compose. Fixed
  compose#10162
  Fixed the goroutine leak in log formatter initialization. Fixed
  compose#10157
  Fixed an issue where compose logs don't exit when all running containers have been stopped. Pull Request
  compose#10181
  Fixed the documentation to reflect
  docker compose ps
  being aligned with
  docker ps
  . Pull Request
  compose#10195
  Fixed an issue where the remote Buildx driver was not found. Fixed
  compose#9893
  Improved logging when recreating a service container. Pull request
  compose#10236
  Fixed an issue so Compose now only waits for containers concerned by the wait condition. Fixed
  compose#10200
  Compose now prevents assignment to entry in nil map. Fixed
  compose#10244
  Added a dedicated GitHub Action workflow for Cucumber tests. Pull Request
  compose#10165
  Cleaned the TUI lines when switching in compact log mode. Fixed
  compose#10201
  Added Tilt watcher to detect code changes in watch mode. Pull Request
  compose#10218
  Compose now supports Dry Run mode for
  kill
  command. Fixed
  compose#10210
  Compose now supports Dry Run mode for
  pause
  command.Fixed
  compose#10217
  Compose now supports Dry Run mode for
  command.Fixed
  compose#10235
  Update
  Dependencies upgrade to fix Golan CVE-2022-27664 and CVE-2022-32149
  Bug fixes and enhancements
  Added support for UTS namespace. Fixed
  compose#8408
  Fixed filtering issue when no filter set. Fixed
  roadmap#418
  Fixed concurrent map writes issue during build step. Pull Request
  compose#10151
  Fixed issue when stdin is not a terminal. Fixed
  compose#9739
  Update
  Dependencies upgrade: bump compose-go to v1.8.1
  Dependencies upgrade: bump cli-docs-tool to 0.5.1
  Bug fixes and enhancements
  Added support of the
  privileged
  attribute in the
  service.build
  section. Pull Request
  compose#10112
  Introduced
  --ignore-buildable
  to ignore buildable images on pull. Fixed
  compose#8805
  Introduced
  --no-attach
  to ignore some service outputs. Fixed
  compose#8546
  Fixed issue with
  logs
  when
  driver:none
  is set. Fixed
  compose#9030
  Compose now relies on dockerCLI.streams. Pull Request
  compose#10082
  Fixed issue with service hash that MUST exclude replicas. Fixed
  compose#10077
  Compose now checks service names based on project, not running containers. Fixed
  compose#9951
  Fixed security opts support (seccomp and unconfined). Fixed
  compose#9505
  Fixed empty file when using compose config in case of smaller source files. Fixed
  compose#10121
  Fixed issue with
  --pull
  not applied on
  compose up
  . Fixed
  compose#10125
  Compose should ignore not only auto-removed containers but also "removal in progress" for orphan containers. Pull Request
  compose#10136
  Compose limits build concurrency according to
  --parallel
  . Fixed
  compose#9091
  Update
  Dependencies upgrade: bump containerd to 1.6.14
  Bug fixes and enhancements
  Compose now uses DOCKER_DEFAULT_PLATFORM to determine the platform when creating a container. Fixed
  compose#10041
  Compose now detects when dependency failed to start. Fixed
  compose#9732
  Fixed WCOW volume mounts. Fixed
  compose#9577
  List only running containers when using
  --all=false
  . Fixed
  compose#10085
  Fixed a regression when running pull
  --ignore-pull-failures
  . Fixed
  compose#10089
  Fixed CPU quota issue. Fixed
  compose#10073
  Fixed race condition on compose logs. Fixed
  compose#8880
  Updated projectOptions to be public by renaming it to ProjectOptions. Fixed
  compose#100102
  Updates
  Dependencies upgrade: bump Go to 1.19.4
  Dependencies upgrade: bump containerd to 1.6.12
  Bug fixes and enhancements
  Added
  --parallel
  to limit concurrent engine calls. Pull Request
  compose#10030
  Distinguished stdout and stderr in
  logs. Fixed
  compose#8098
  Aligned
  compose ps
  output with
  docker ps
  . Fixed
  compose#6867
  Added
  --include-deps
  to push command. Pull Request
  compose#10044
  Introduced
  --timestamp
  option on
  compose up
  . Fixed
  compose#5730
  Compose now applies uid/gid when creating a secret from the environment. Pull Request
  compose#10084
  Fixed deadlock when waiting for attached-dependencies. Fixed
  compose#10021
  Fixed race condition when collecting pulled images IDs. Fixed
  compose#9897
  Compose doesn't stop the
  pull
  command for images that can be built. Fixed
  compose#8724
  Fixed corner case when there's no container to attach to. Fixed
  compose#8752
  Compose containers' startup must run sequentially for engine to assign distinct ports within a configured range. Fixed
  compose#8530
  Fixed parsing of
  repository:tag
  . Fixed
  compose#9208
  Load project from files when explicitly set by user. Fixed
  compose#9554
  Updates
  Dependencies upgrade: bump compose-go to
  v1.8.0
  Dependencies upgrade: bump Go to 1.19.3
  Bug fixes and enhancements
  Added
  oom_score_adj
  field to service definition. Pull Request
  compose#10019
  Added mode field for tmpfs mount permissions. Pull Request
  compose#10031
  Compose now only stops services started by
  when interrupted. Fixed
  compose#10028
  Compose now loads implicit profiles for targeted services. Fixed
  compose#10025
  Compose does not require
  service.build.platforms
  to be set if
  service.platform
  is set. Fixed
  compose#10017
  Plain output is used during buildx image builds if
  --ansi=never
  is set. Fixed
  compose#10020
  COMPOSE_IGNORE_ORPHANS
  environment variable now behaves more consistently. Fixed
  compose#10035
  Compose now uses the correct image name separator in
  convert
  . Fixed
  compose#9904
  Fixed
  for services using
  network_mode: service:NAME
  . Fixed
  compose#10036
  Updates
  Dependencies upgrade: bump containerd to 1.6.10
  Dependencies upgrade: bump docker-credential-helpers to v0.7.0
  Update CI dependencies. Pull Request
  compose#9982
  Bug fixes and enhancements
  Added a
  no-consistency
  option to
  convert
  command. Fixed
  compose#9963
  Added a
  build
  option to
  command. Fixed
  compose#10003
  Fixed mapping
  restart_policy.condition
  to engine supported values. Fixed
  compose#8756
  docs#15936
  Fixed missing support of
  deploy.reservation.memory
  . Fixed
  compose#9902
  Fixed a bug to prevent usage of
  COMPOSE_PROFILES
  when
  --profile
  arg is used. Fixed
  compose#9895
  Fixed a bug to prevent pulling a service's image when depending on a service which will build this image. Fixed
  compose#9983
  Fixed parsing issue when a container number label is not found. Fixed
  compose#10004
  Compose now uses the platform value defined by
  DOCKER_DEFAULT_PLATFORM
  when no
  service.platform
  defined. Fixed
  compose#9889
  Removed usage of the deprecated dependency
  gotest.tools
  v2. Pull Request
  compose#9935
  Excluded issues labeled with
  kind/feature
  from stale bot process. Fixed
  compose#9988
  Updates
  Updated Docker Engine API to restore compatibility with Golang 1.18 needed for Linux packaging. Pull Request
  compose#9940
  For the full change log or additional information, check the
  Compose repository 2.12.2 release page
  Security
  Updated Docker Engine API to apply fix of
  CVE-2022-39253
  . Pull Request
  compose#9934
  For the full change log or additional information, check the
  Compose repository 2.12.1 release page
  Updates
  CI update to the documentation repository path
  Upgraded to compose-go from
  1.5.1 to 1.6.0
  Updated to go 1.19.2 to address CVE-2022-2879, CVE-2022-2880, CVE-2022-41715
  Bug fixes and enhancements
  Added a
  quiet
  option when pushing an image. Fixed
  compose#9089
  Fixed a misleading error message for
  port
  command. Pull Request
  compose#9909
  Fixed a bug to prevent failure when Compose tries to remove a non-existing container. Fixed by
  compose#9896
  Switched GitHub issue template form
  For the full change log or additional information, check the
  Compose repository 2.12.0 release page
  Note
  Updates on environment file syntax & interpolation: see
  compose#9879
  Setting
  DOCKER_HOST
  .env
  files is not supported in Compose v2
  Updates
  Upgraded to compose-go from
  1.5.1 to 1.6.0
  Bug fixes and enhancements
  Fixed a bug to prevent "invalid template" errors on valid environment variable values. Fixes
  compose##9806
  compose##9746
  compose##9704
  compose##9294
  Fixed a bug to ensure new images from
  docker compose build
  are used. Fixes
  compose#9856
  Fixed cross-architecture builds when
  DOCKER_DEFAULT_PLATFORM
  not set. Fixes
  compose#9864
  Fixed intermittent conflict errors when using
  depends_on
  . Fixes
  compose#9014
  Cleared service
  when entry point is overridden. Fixes
  compose#9622
  Configured default builder export when no
  build.platforms
  defined. Fixes
  compose#9856
  Fixed a bug to keep the platform defined, in priority, via DOCKER_DEFAULT_PLATFORM or the
  service.platform
  attribute. Fixes
  compose#9864
  Removed support for
  DOCKER_HOST
  .env
  files. Fixes
  compose#9210
  Fixed a bug to ensure clean service command if entry point is overridden in run command. Fixes
  compose#9622
  Deps: fixed race condition during graph traversal. Fixes
  compose#9014
  CI now runs on Windows & macOS including E2E tests via Docker Desktop
  Added more information when
  service.platform
  isn't part of
  service.build.platforms
  GitHub Workflows security hardening
  For the full change log or additional information, check the
  Compose repository 2.11.2 release page
  Bug fixes and enhancements
  Fixed a bug to keep
  depends_on
  condition when service has
  volumes_from
  . Fixes
  compose#9843
  Fixed a bug to keep the platform defined at service level during build if no build platforms. Fixes
  compose#9729
  Fixed a bug to keep the platform defined via DOCKER_DEFAULT_PLATFORM during build if no build platforms provided. Fixes
  compose#9853
  For the full change log or additional information, check the
  Compose repository 2.11.1 release page
  Updates
  Dependencies upgrade: bump Golang to 1.19.1
  Dependencies upgrade: bump github.com/docker/go-units from 0.4.0 to 0.5.0
  Dependencies upgrade: bump github.com/cnabio/cnab-to-oci from 0.3.6 to 0.3.7
  Dependencies upgrade: bump go.opentelemetry.io/otel from 1.9.0 to 1.10.0
  Dependencies upgrade: bump github.com/AlecAivazis/survey/v2 from 2.3.5
  Dependencies upgrade: bump go.opentelemetry.io/otel from 1.4.1 to 1.9.0
  Dependencies upgrade: bump compose-go from
  1.5.0 to 1.5.1
  Bug fixes and enhancements
  Added platforms build. Fixes
  compose-spec#267
  Logs now filter to services from current Compose file. Fixes
  compose#9801
  Added an improved output warning when pulling images. Fixes
  compose#9820
  Fixed a bug to ensure correct capture of exit code when service has dependencies. Fixes
  compose#9778
  Fixed
  down
  with
  --rmi
  . Fixes
  compose#9655
  Fixed docker-compose convert that turns $ into $$ when using the --no-interpolate option. Fixes
  compose#9160
  Fixed
  build.go
  access custom labels directly cause panic. See
  compose#9810
  Applied newly loaded envvars to "DockerCli" and "APIClient". Fixes
  compose#9210
  Only attempt to start specified services on
  compose start [services]
  . Fixes
  compose#9796
  compose#9807
  Label built images for reliable cleanup on
  down
  . Fixes
  compose#9655
  For the full change log or additional information, check the
  Compose repository 2.11.0 release page
  Bug fixes and enhancements
  Properly respect
  DOCKER_TLS_VERIFY
  DOCKER_CERT_PATH
  environment variables. Fixes
  compose#9789
  Improved
  Makefile
  used in
  docker/docker-ce-packaging#742
  For the full change log or additional information, check the
  Compose repository 2.10.2 release page
  Updates
  Dependencies update: Bumped github.com/moby/buildkit from
  0.10.3 to 0.10.4
  Bug fixes and enhancements
  Fixed image pulls being skipped when
  pull_policy
  was not set. Fixes
  compose#9773
  Restored
  .sha256
  checksum files in release artifacts. Fixes
  compose#9772
  Removed error message showing exit code when using --exit-code-from. Fixes
  compose#9782
  Fixed
  compose pull
  to pull images even when they existed locally if
  tag=latest
  CI: Fixed checksums checking and brought back individual checksum files.
  For the full change log or additional information, check the
  Compose repository 2.10.1 release page
  Applied newly loaded environment variables to
  DockerCli
  APIClient
  . Fixes
  compose#9210
  Added support for windows/arm64 and linux/riscv64.
  Updates
  Updated Dockerfile syntax to latest stable and renamed docs Dockerfile.
  Dependencies update: Upgraded BuildKit & docker/distribution.
  Dependencies update: Updated Docker CLI version used in CI to v20.10.17.
  Dependencies update: Bumped github.com/containerd/containerd from
  1.6.6 to 1.6.7
  Dependencies update: Bump github.com/containerd/containerd from
  1.6.7 to 1.6.8
  Dependencies update: Bumped to Go 1.18.5.
  Dependencies update: Bumped github.com/cnabio/cnab-to-oci from
  0.3.5 to 0.3.6
  Bug fixes and enhancements
  Reverted environment variables precedence to OS over
  .env
  file. Fixes
  compose#9737
  Updated usage strings for consistency.
  Resolved environment variables case-insensitively on Windows. Fixes
  compose#9431
  Fixed
  compose up
  so dependency containers aren't stopped when a stop signal is issued. This keeps parity with v1 behavior-wise.
  Fixes
  compose#9696
  Fixed commands that start/restart/pause/unpause so that, if ran from the Compose file, the Compose model is also applied. Fixes
  compose#9705
  compose#9705
  Removed extra whitespaces in help text of some subcommands.
  Fixed
  compose create
  to not override service pull policy when the value from the command line is configured as the default. Fixes
  compose#9717
  Filtered out "commandConn.Close- warning" message. Fixes
  compose#8544
  Fixed up/start/run to not wait for disabled dependency. Fixes
  compose#9591
  Applied Compose model on
  compose kill
  , added
  --remove-orphans
  option. Fixes
  compose#9742
  Fixed
  compose pull
  to avoid pulling the same images multiple times. Fixes
  compose#8768
  Fixed version of golangci-lint to v1.47.3, issue with v1.48.0 for now.
  For the full change log, check the
  Compose repository 2.10.0 release page
  Important
  Compose v2.9.0 contains changes to the environment variable's precedence that have since been reverted. We recommend using v2.10+ to avoid compatibility issues.
  Note
  This release reverts the breaking changes introduced in
  Compose v2.8.0
  compose-go v1.3.0
  Updates
  Updated
  compose-go
  to v1.4.0
  as previous version introduced breaking changes. Fixes
  compose#9700
  Bug fixes and enhancements
  Overwritten parent commands PreRun code for
  compose version
  . Fixes
  compose#9698
  Fixed
  LinkLocalIPs
  in V2. Fixes
  compose#9692
  Linked to
  BUILDING.md
  for testing instructions. Fixes
  compose#9439
  For the full change log or additional information, check the
  Compose repository 2.9.0 release page
  Important
  This release introduced a breaking change via
  compose-go v1.3.0
  and this
  In this release, Docker Compose recreates new resources (networks, volumes, secrets, configs, etc.) with new names, using a
  (dash) instead an
  (underscore) and tries to connect to or use these newly created resources instead of your existing ones!
  Please use Compose the v2.9.0 release instead.
  Introduced
  --pull
  flag to allow the force pull of updated service images. Fixes
  compose#9451
  Increased code quality by adding
  gocritic
  to the linters.
  Bug fixes and enhancements
  Fixed interpolation error message output. Fixes
  compose-spec/compose-go#292
  Defined precedence of the environment variables evaluation. Fixes
  compose#9521
  compose#9638
  compose#9608
  compose#9578
  compose#9468
  , and
  compose#9683
  Docs CI: Fixed to use push-to-fork when creating a PR.
  Used environmental variable for golang's version and updates GitHub Actions from v2 to v3.
  Used
  google/addlicense
  instead of
  kunalkushwaha/ltag
  For the full change log or additional information, check the
  Compose repository 2.8.0 release page
  Added support for environment secrets during build step. Fixes
  compose#9606
  Updates
  Dependencies upgrade: bumped
  go to 1.18.4
  Dependencies upgrade: bumped
  compose-go to v1.2.9
  Bug fixes and enhancements
  Networks: prevented issues due to duplicate names. Fixes
  moby/moby#18864
  Fixed issue with close networks name on
  compose up
  compose down
  commands. Fixes
  compose#9630
  Used appropriate dependency condition for one-shot containers when running
  compose up --wait
  . Fixes
  compose#9606
  Fixed environment variable expansion.
  Validated depended-on services exist in consistency check. Fixes
  compose#8910
  Fixed hash usage in environment values. Fixes
  compose#9509
  Docker Build: added fix to respect dependency order for classic builder. Fixes
  compose#8538
  Fixed panic caused by empty string argument. Fixes
  compose-switch#35
  Fixed start/restart as to not impact one-off containers. Fixes
  compose#9509
  Fixed to keep the container reference when
  volumes_from
  targets a container and not a service. Fixes
  compose#8874
  build.go: added fix to initialize
  CustomLabels
  map if
  Added new targets to build Compose binary before running e2e tests.
  CI: released workflow to open a PR on docs repo with latest changes.
  e2e: added test for
  e2e: split out pause tests and add more cases.
  e2e: add more start/stop test cases.
  For the full change log or additional information, check the
  Compose repository 2.7.0 release page
  Added support for setting secrets from environment variable. Fixes
  compose-spec/compose-spec#251
  Updates
  Upgrade: compose-go
  v1.2.8
  Upgrade: buildx
  v0.8.2
  Dependencies upgrade: bumped runc
  to 1.1.2
  Dependencies upgrade: bumped golang to
  Dependencies upgrade: bumped compose-go to
  v1.2.8
  Dependencies upgrade: bumped github.com/theupdateframework/notary from 0.6.1 to 0.7.0.
  Dependencies upgrade: bumped github.com/cnabio/cnab-to-oci from 0.3.1-beta1 to 0.3.3.
  Dependencies upgrade: bumped github.com/hashicorp/go-version from 1.3.0 to 1.5.0.
  Dependencies upgrade: bumped github.com/stretchr/testify from 1.7.0 to 1.7.2.
  Dependencies upgrade: bumped github.com/docker/buildx from 0.8.1 to 0.8.2.
  Dependencies upgrade: bumped github.com/AlecAivazis/survey/v2 from 2.3.2 to 2.3.5.
  Dependencies upgrade: bumped github.com/containerd/containerd from 1.6.2 to 1.6.6.
  Bug fixes and enhancements
  Added links to container create request. Fixes
  #9513
  Fixed
  compose run
  to start only direct dependencies. Fixes
  #9459
  Fixed
  compose up
  'service not found' errors when using
  --no-deps
  option. Fixes
  #9427
  Fixed
  compose down
  to respect
  COMPOSE_REMOVE_ORPHANS
  environment variable. Fixes
  #9562
  Fixed project-level bind mount volumes. Fixes
  docker/for-mac#6317
  Fixed parsing of properties
  deploy.limits.cpus
  deploy.limits.pids
  to respect floating-point values. Fixes
  #9542
  #9501
  Fixed
  compose ps
  output to list all exposed ports. Fixes
  #9257
  Fixed spelling mistakes in
  compose ps
  code.
  Fixed
  docker compose
  to honor
  --no-ansi
  even when deprecated option is requested.
  Fixed network name and network ID possible ambiguity.
  e2e: added test for
  e2e: unmarshalled json into container summaries.
  e2e: fixed subtests and block parallel unsafe tests.
  e2e: isolated test command env from system env.
  e2e: fixed spurious
  failures.
  e2e: ensured all compose commands standalone compatible.
  e2e: improved test output on failures.
  For the full change log or additional information, check the
  Compose repository 2.6.1 release page
  Added the tags property to the build section. In this property tags can be defined to be applied to the final image, in addition to the one defined in the image property.
  Added end-to-end tests to ensure there is no regression on environment variables precedence.
  Added ddev's end-to-end test.
  Updates
  Dependencies update: bumping
  compose-go to 1.2.6
  Dependencies update: bumping
  compose-go to 1.2.7
  Dependencies update: bumping
  golang to 1.18
  Bug fixes and enhancements
  Fixed
  compose up
  to attach only to services declared in project with enabled profiles. Fixes
  #9286
  Fixed flickering prompt when pulling same image from multiple services. Fixes
  #9469
  Fixed compose go to import .env file to OS environment to allow setting variables (such as DOCKER_BUILDKIT) through this file. Fixes
  #9345
  Fixed
  TestLocalComposeUp
  that failed locally.
  Fixed local run of make
  e2e-compose-standalone
  For the full change log or additional information, check the
  Compose repository 2.6.0 release page
  Updates
  Dependencies updates: bumping compose-go to 1.2.5.
  Bug fixes and enhancements
  Fixed resolution of project's working directive absolute path when a relative path is declared using '--env-file'. Fixes
  docker/for-mac#6229
  Fixed
  compose down
  : now rejects all arguments in order to clarify usage. Fixes
  #9151
  Fixed
  compose down
  : now exits with status=0 if there is nothing to remove. Fixes
  #9426
  Fixed extra space printed in logs output lines with --no-log-prefix option. Fixes
  #9464
  Clarified what the default work dir is when multiple compose files are passed.
  cp command: copy to all containers of a service as default behavior.
  For the full change log or additional information, check the
  Compose repository 2.5.1 release page
  Bug fixes and enhancements
  Fixed panic with
  compose down
  command when
  flag specified. Fixes
  #9353
  Passed newly created project as input to start services (
  docker compose up
  ). Fixes
  #9356
  Included services declared under links in docker-compose file as implicit dependencies. Fixes
  #9301
  Added changes
  docker compose pull
  command to respect defined policy: 1) skip services configured as
  pull_policy: never
  and 2) ignore those with an existing image and
  pull_policy: missing
  . Fixes
  #3660
  Error building project from resources is no longer ignored in order to prevent
  down
  panic. Fixes
  #9383
  Enforced project name to be lowercase. Fixes
  #9378
  Added support to build-time secrets. Fixes
  #6358
  Changed
  compose-go
  to allow (re)building volume string to be used by engine
  bind
  API when mount can't be used. Fixes
  #9380
  Provided checksums.txt file and added
  --binary
  to allow verification in different OS. Fixes
  #9388
  Added changes so locally pulled image's ID is inspected and persisted to
  com.docker.compose.image
  . Fixes
  #9357
  Fixed issue regarding IPAM gateway setup. Fixes
  #9330
  Added support for ppc64le architecture for docker compose binary.
  Fixed search/replace typo in
  --no-TTY
  documentation.
  For the full change log or additional information, check the
  Compose repository 2.5.0 release page
  Bug fixes and enhancements
  Passed the
  --rm flag
  value as is to the Docker CLI when running a container with this flag. Fixes
  #9314
  Added ssh config to the build options when building an image from a
  docker compose up
  command. Fixes
  #9338
  Added inspection to container checking if a TTY is required. Running services with
  tty:true
  specified now show console output. Fixes
  #9288
  For the full change log or additional information, check the
  Compose repository 2.4.1 release page
  Updates
  Dependencies update: Bumped buildx to v0.8.1. to fix possible panic on handling build context scanning errors.
  Bug fixes and enhancements
  Passed the interactive flag '-i' from the Compose CLI to the Docker one to run exec command. Fixes
  #9315
  Compose commands now take the value of
  COMPOSE_PROJECT_NAME
  environmental variable into consideration. Fixes
  #9316
  Fixed issue of
  compose down
  command that when executed in contexts without any services started or resources to be deleted was returning an error. Error was due to command trying to delete an inexistent default network. Fixes
  #9333
  Introduced support for
  cache_from
  cache_to
  no_cache
  pull
  attributes in the build section. These attributes allow forcing a complete rebuild from sources and checking with registry for images used. These changes provide the basis for offering
  --no-cache
  --pull
  options for compose build (or equivalent) command down the line.
  Introduced support of an
  --ssh
  flag for the
  build
  command from CLI and Compose file. Fixes
  #7025
  Fixed typo in
  --ssh
  flag description. Related to
  #7025
  Pinned Kubernetes dependencies to the same version as in buildx.
  Passed the interactive flag from the Compose CLI to the Docker one to run exec command.
  Fixed race condition on start-stop end-to-end tests running in parallel.
  Removed code regarding an obsolete warning.
  Vendor: github.com/containerd/containerd v1.6.2. Includes a fix for CVE-2022-24769 (doesn't affect our codebase).
  For the full change log or additional information, check the
  Compose repository 2.4.0 release page
  Introduced changes to use RunExec and RunStart from docker/cli to handle all the interactive/tty/* terminal logic.
  Removed
  Removed a container with no candidate now produces a warning instead of an error. Fixes
  #9255
  Removed the "Deprecated" mentions from -i and -t options to run and exec commands. These options are on by default and in use. Fixes
  #9229
  Removed the "Deprecated" mention from the --filter flag, to keep consistency with other commands.
  Removed the need to get the original compose.yaml file to run 'docker compose kill'.
  Updates
  Dependencies update: Bumped github.com/spf13/cobra from 1.3.0 to 1.4.0. Cobra library no longer requires Viper and all of its indirect dependencies
  See cobra's release page
  Dependencies update: Bumped buildx from v0.7.1 to v0.8.0.
  Bug fixes and enhancements
  Recovered behavior for 'compose up -d' of recreating containers of compose file images with refreshed content. Fixes
  #9259
  Docker compose --status, --filter and --format flags documentation updates.
  docker compose down -v
  now does not remove external volumes and networks as per the option's expected and documented behavior. Whenever project is specified it is also now used to enforce down to only remove resources listed in compose.yaml file.
  Fixes
  #9172
  #9145
  Changed Compose API reference docs automation to pick up diffs code vs. docs.
  For the full change log or additional information, check the
  Compose repository 2.3.4 release page
  Other Releases
  (2022-03-8 to 2022-04-14)
  For the releases later than 1.29.2 and earlier than 2.3.4, please check the
  Compose repository release pages
  (2021-05-10)
  Miscellaneous
  Removed the prompt to use
  docker-compose
  in the
  command.
  Bumped
  requirements-indirect.txt
  (2021-04-13)
  Bugs
  Fixed invalid handler warning on Windows builds.
  Fixed config hash to trigger container re-creation on IPC mode updates.
  Fixed conversion map for
  placement.max_replicas_per_node
  Removed extra scan suggestion on build.
  (2021-04-06)
  Features
  Added profile filter to
  docker-compose config
  Added a
  depends_on
  condition to wait for successful service completion.
  Miscellaneous
  Added an image scan message on build.
  Updated warning message for
  --no-ansi
  to mention
  --ansi never
  as alternative.
  Bumped docker-py to 5.0.0.
  Bumped PyYAML to 5.4.1.
  Bumped python-dotenv to 0.17.0.
  (2021-03-23)
  Bug fixes
  Made
  --env-file
  relative to the current working directory. Environment file paths set with
  --env-file
  are now relative to the current working directory and override the default
  .env
  file located in the project directory.
  Fixed missing service property
  storage_opt
  by updating the Compose schema.
  Fixed build
  extra_hosts
  list format.
  Removed additional error message on
  exec
  Miscellaneous
  Added
  compose.yml
  compose.yaml
  to the default filename list.
  (2021-02-26)
  Bugs
  Fixed the OpenSSL version mismatch error when shelling out to the SSH client (via bump to docker-py 4.4.4 which contains the fix).
  Added missing build flags to the native builder:
  platform
  isolation
  extra_hosts
  Removed info message on native build.
  Fixed the log fetching bug when service logging driver is set to 'none'.
  (2021-02-18)
  Bug fixes
  Fixed SSH port parsing by bumping docker-py to 4.4.3.
  Miscellaneous
  Bumped Python to 3.7.10.
  (2021-02-17)
  Bug fixes
  Fixed SSH hostname parsing when it contains a leading 's'/'h', and removed the quiet option that was hiding the error (via docker-py bump to 4.4.2).
  Fixed key error for
  --no-log-prefix
  option.
  Fixed incorrect CLI environment variable name for service profiles:
  COMPOSE_PROFILES
  instead of
  COMPOSE_PROFILE
  Fixed the fish completion.
  Miscellaneous
  Bumped cryptography to 3.3.2.
  Removed the log driver filter.
  For a list of PRs and issues fixed in this release, see
  Compose 1.28.3
  (2021-01-26)
  Bug fixes
  Revert to Python 3.7 bump for Linux static builds
  Add bash completion for
  docker-compose logs|up --no-log-prefix
  Miscellaneous
  CI setup update
  (2021-01-20)
  Features
  Added support for NVIDIA GPUs through device requests.
  Added support for service profiles.
  Changed the SSH connection approach to the Docker CLI by shelling out to the local SSH client. Set the
  COMPOSE_PARAMIKO_SSH=1
  environment variable to enable the old behavior.
  Added a flag to disable log prefix.
  Added a flag for ANSI output control.
  Docker Compose now uses the native Docker CLI's
  build
  command when building images. Set the
  COMPOSE_DOCKER_CLI_BUILD=0
  environment variable to disable this feature.
  Bug fixes
  Made
  parallel_pull=True
  by default.
  Restored the warning for configs in non-swarm mode.
  Took
  --file
  into account when defining
  project_dir
  Fixed a service attach bug on
  compose up
  Miscellaneous
  Added usage metrics.
  Synced schema with COMPOSE specification.
  Improved failure report for missing mandatory environment variables.
  Bumped
  attrs
  to 20.3.0.
  Bumped
  more_itertools
  to 8.6.0.
  Bumped
  cryptograhy
  to 3.2.1.
  Bumped
  cffi
  to 1.14.4.
  Bumped
  virtualenv
  to 20.2.2.
  Bumped
  bcrypt
  to 3.2.0.
  Bumped GitPython to 3.1.11.
  Bumped
  docker-py
  to 4.4.1.
  Bumped Python to 3.9.
  Linux: bumped Debian base image from stretch to buster (required for Python 3.9).
  macOS: Bumped OpenSSL 1.1.1g to 1.1.1h, and Python 3.7.7 to 3.9.0.
  Bumped PyInstaller to 4.1.
  Relaxed the restriction on base images to latest minor.
  Updated READMEs.
  (2020-09-24)
  Bug fixes
  Removed path checks for bind mounts.
  Fixed port rendering to output long form syntax for non-v1.
  Added protocol to the Docker socket address.
  (2020-09-16)
  Bug fixes
  Merged
  max_replicas_per_node
  docker-compose config
  Fixed
  depends_on
  serialization on
  docker-compose config
  Fixed scaling when some containers are not running on
  docker-compose up
  Enabled relative paths for
  driver_opts.device
  local
  driver.
  Allowed strings for
  cpus
  fields.
  (2020-09-10)
  Bug fixes
  Fixed bug on
  docker-compose run
  container attach.
  (2020-09-10)
  Bug fixes
  Fixed
  docker-compose run
  when
  service.scale
  is specified.
  Allowed the
  driver
  property for external networks as a temporary workaround for the Swarm network propagation issue.
  Pinned the new internal schema version to
  as the default.
  Preserved the version number configured in the Compose file.
  (2020-09-07)
  Features
  Merged 2.x and 3.x Compose formats and aligned with
  COMPOSE_SPEC
  schema.
  Implemented service mode for
  Passed
  COMPOSE_PROJECT_NAME
  environment variable in container mode.
  Made
  behave in the same way as
  Used
  docker build
  docker-compose run
  when
  COMPOSE_DOCKER_CLI_BUILD
  environment variable is set.
  Used the docker-py default API version for engine queries (
  auto
  Parsed
  network_mode
  on build.
  Bug fixes
  Ignored build context path validation when building is not required.
  Fixed float to bytes conversion via docker-py bump to 4.3.1.
  Fixed the scale bug when the deploy section is set.
  Fixed
  docker-py
  bump in
  setup.py
  Fixed experimental build failure detection.
  Fixed context propagation to the Docker CLI.
  Miscellaneous
  Bumped
  docker-py
  to 4.3.1.
  Bumped
  to 3.19.0.
  Bumped
  virtualenv
  to 20.0.30.
  Added script for Docs synchronization.
  (2020-07-02)
  Bug fixes
  Enforced
  docker-py
  4.2.2 as minimum version when installing with pip.
  (2020-06-30)
  Features
  Bumped
  docker-py
  from 4.2.1 to 4.2.2.
  Bug fixes
  Enforced
  docker-py
  4.2.1 as minimum version when installing with pip.
  Fixed context load for non-docker endpoints.
  (2020-06-03)
  Features
  Added
  docker context
  support.
  Added missing test dependency
  setup.py
  Added
  --attach-dependencies
  to command
  for attaching to dependencies.
  Allowed compatibility option with
  COMPOSE_COMPATIBILITY
  environment variable.
  Bumped
  Pytest
  to 5.3.4 and add refactor compatibility with the new version.
  Bumped
  OpenSSL
  from 1.1.1f to 1.1.1g.
  Bumped
  certifi
  from 2019.11.28 to 2020.4.5.1.
  Bumped
  docker-py
  from 4.2.0 to 4.2.1.
  Bug fixes
  Properly escaped values coming from
  env_files
  Synchronized compose-schemas with upstream (docker/cli).
  Removed
  None
  entries on exec command.
  Added
  distribution
  package to get distribution information.
  Added
  python-dotenv
  to delegate
  .env
  file processing.
  Stopped adjusting output on terminal width when piped into another command.
  Showed an error message when
  version
  attribute is malformed.
  Fixed HTTPS connection when
  DOCKER_HOST
  is remote.
  (2020-04-10)
  Features
  Bumped OpenSSL from 1.1.1d to 1.1.1f.
  Added Compose version 3.8.
  Limited service scale to the size specified by the field
  deploy.placement.max_replicas_per_node
  (2020-02-03)
  Bug fixes
  Fixed the CI script to enforce the minimal MacOS version to 10.11.
  Fixed docker-compose exec for keys with no value on environment files.
  (2020-01-23)
  Bug fixes
  Fixed the CI script to enforce the compilation with Python3.
  Updated the binary's sha256 on the release page.
  (2020-01-20)
  New features
  Docker Compose now allows the compatibility option with
  COMPOSE_COMPATIBILITY
  environment variable.
  Bug fixes
  Fixed an issue that caused Docker Compose to crash when the
  version
  field was set to an invalid value. Docker Compose now displays an error message when invalid values are used in the version field.
  Fixed an issue that caused Docker Compose to render messages incorrectly when running commands outside a terminal.
  (2020-01-06)
  Bugfixes
  Decoded the
  APIError
  explanation to Unicode before using it to create and start a container.
  Docker Compose discards
  com.docker.compose.filepaths
  labels that have
  None
  as value. This usually occurs when labels originate from stdin.
  Added OS X binary as a directory to solve slow start up time issues caused by macOS Catalina binary scan.
  Passed the
  environment variable in container mode when running with
  script/run/run.sh
  Docker Compose now reports images that cannot be pulled, however, are required to be built.
  (2019-11-18)
  New features
  Set no-colors to true by changing
  CLICOLOR
  env variable to
  Added working directory, config files, and env file to service labels.
  Added ARM build dependencies.
  Added BuildKit support (use
  DOCKER_BUILDKIT=1
  COMPOSE_DOCKER_CLI_BUILD=1
  Raised Paramiko to version 2.6.0.
  Added the following tags:
  docker-compose:latest
  docker-compose:<version>-alpine
  , and
  docker-compose:<version>-debian
  Raised
  docker-py
  to version 4.1.0.
  Enhanced support for
  requests
  , up to version 2.22.0.
  Removed empty tag on
  build:cache_from
  Dockerfile
  enhancement that provides for the generation of
  libmusl
  binaries for Alpine Linux.
  Pulling only of images that cannot be built.
  scale
  attribute now accepts
  as a value.
  Added a
  --quiet
  option and a
  --no-rm
  option to the
  docker-compose build
  command.
  Added a
  --no-interpolate
  option to the
  docker-compose config
  command.
  Raised OpenSSL for MacOS build from
  1.1.1c
  Added support for the
  docker-compose.yml
  file's
  credential_spec
  configuration option.
  Resolution of digests without having to pull the image.
  Upgraded
  pyyaml
  to version
  4.2b1
  Lowered the severity to
  warning
  for instances in which
  down
  attempts to remove a non-existent image.
  Mandated the use of improved API fields for project events, when possible.
  Updated
  setup.py
  for modern
  pypi/setuptools
  , and removed
  pandoc
  dependencies.
  Removed
  Dockerfile.armhf
  , which is no longer required.
  Bug fixes
  Made container service color deterministic, including the removal of the color red.
  Fixed non-ASCII character errors (Python 2 only).
  Changed image sizing to decimal format, to align with Docker CLI.
  size acquired through Python POSIX support.
  Fixed same file
  extends
  optimization.
  Fixed
  stdin_open
  Fixed the issue of
  --remove-orphans
  being ignored encountered during use with
  up --no-start
  option.
  Fixed
  docker-compose ps --all
  command.
  Fixed the
  depends_on
  dependency recreation behavior.
  Fixed bash completion for the
  docker-compose build --memory
  command.
  Fixed the misleading environmental variables warning that occurs when the
  docker-compose exec
  command is performed.
  Fixed the failure check in the
  parallel_execute_watch function
  Fixed the race condition that occurs following the pulling of an image.
  Fixed error on duplicate mount points (a configuration error message now displays).
  Fixed the merge on
  networks
  section.
  Compose container is always connected to
  stdin
  by default.
  Fixed the presentation of failed services on the
  docker-compose start
  command when containers are not available.
  (2019-06-24)
  This release contains minor improvements and bug fixes.
  (2019-03-28)
  Features
  Added support for connecting to the Docker Engine using the
  protocol.
  Added an
  --all
  flag to
  docker-compose ps
  to include stopped one-off containers
  in the command's output.
  Added bash completion for
  ps --all|-a
  Added support for credential_spec.
  Added
  --parallel
  docker build
  's options in
  bash
  completion.
  Bug fixes
  Fixed a bug where some valid credential helpers weren't properly handled by Compose
  when attempting to pull images from private registries.
  Fixed an issue where the output of
  docker-compose start
  before containers were created
  was misleading.
  Compose will no longer accept whitespace in variable names sourced from environment files.
  This matches the Docker CLI behavior.
  Compose will now report a configuration error if a service attempts to declare
  duplicate mount points in the volumes section.
  Fixed an issue with the containerized version of Compose that prevented users from
  writing to stdin during interactive sessions started by
  exec
  One-off containers started by
  no longer adopt the restart policy of the service,
  and are instead set to never restart.
  Fixed an issue that caused some container events to not appear in the output of
  docker-compose events
  command.
  Missing images will no longer stop the execution of
  docker-compose down
  commands. A warning is
  now displayed instead.
  Force
  virtualenv
  version for macOS CI.
  Fixed merging of Compose files when network has
  None
  config.
  Fixed
  CTRL+C
  issues by enabling
  bootloader_ignore_signals
  pyinstaller
  Bumped
  docker-py
  version to
  to fix SSH and proxy configuration issues.
  Fixed release script and some typos on release documentation.
  (2018-11-28)
  Bug fixes
  Reverted a 1.23.0 change that appended random strings to container names
  created by
  docker-compose up
  , causing addressability issues.
  Note
  Containers created by
  docker-compose run
  will continue to use randomly generated names to avoid collisions during parallel runs.
  Fixed an issue where some
  dockerfile
  paths would fail unexpectedly when
  attempting to build on Windows.
  Fixed a bug where build context URLs would fail to build on Windows.
  Fixed a bug that caused
  exec
  commands to fail for some otherwise
  accepted values of the
  --host
  parameter.
  Fixed an issue where overrides for the
  storage_opt
  isolation
  keys in
  service definitions weren't properly applied.
  Fixed a bug where some invalid Compose files would raise an uncaught
  exception during validation.
  (2018-11-01)
  Bug fixes
  Fixed a bug where working with containers created with a version of Compose earlier than
  would cause unexpected crashes.
  Fixed an issue where the behavior of the
  --project-directory
  flag would
  vary depending on which subcommand was used.
  (2018-10-30)
  Important note
  The default naming scheme for containers created by Compose in this version
  has changed from
  <project>_<service>_<index>
  <project>_<service>_<index>_<slug>
  , where
  <slug>
  is a randomly-generated
  hexadecimal string. Please make sure to update scripts relying on the old
  naming scheme accordingly before upgrading.
  Features
  Logs for containers restarting after a crash will now appear in the output
  of the
  logs
  commands.
  Added
  --hash
  option to the
  docker-compose config
  command, allowing users
  to print a hash string for each service's configuration to facilitate rolling
  updates.
  Added
  --parallel
  flag to the
  docker-compose build
  command, allowing
  Compose to build up to 5 images simultaneously.
  Output for the
  pull
  command now reports status / progress even when pulling
  multiple images in parallel.
  For images with multiple names, Compose will now attempt to match the one
  present in the service configuration in the output of the
  images
  command.
  Bug fixes
  Fixed an issue where parallel
  commands for the same service would fail due to name
  collisions.
  Fixed an issue where paths longer than 260 characters on Windows clients would
  cause
  docker-compose build
  to fail.
  Fixed a bug where attempting to mount
  /var/run/docker.sock
  with
  Docker Desktop for Windows would result in failure.
  --project-directory
  option is now used by Compose to determine where to
  look for the
  .env
  file.
  docker-compose build
  no longer fails when attempting to pull an image with
  credentials provided by the
  gcloud credential helper
  Fixed the
  --exit-code-from
  option in
  docker-compose up
  to always report
  the actual exit code even when the watched container is not the cause of the
  exit.
  Fixed an issue that would prevent recreating a service in some cases where
  a volume would be mapped to the same mountpoint as a volume declared within the Dockerfile for that image.
  Fixed a bug that caused hash configuration with multiple networks to be
  inconsistent, causing some services to be unnecessarily restarted.
  Fixed a bug that would cause failures with variable substitution for services
  with a name containing one or more dot characters.
  Fixed a pipe handling issue when using the containerized version of Compose.
  Fixed a bug causing
  external: false
  entries in the Compose file to be
  printed as
  external: true
  in the output of
  docker-compose config
  Fixed a bug where issuing a
  docker-compose pull
  command on services
  without a defined image key would cause Compose to crash.
  Volumes and binds are now mounted in the order they are declared in the
  service definition.
  Miscellaneous
  completion script has been updated with new options, and no
  longer suggests container names where service names are expected.
  (2018-07-17)
  New features
  Compose format version 3.7
  Introduced version 3.7 of the
  docker-compose.yml
  specification.
  This version requires Docker Engine 18.06.0 or above.
  Added support for
  rollback_config
  in the deploy configuration
  Added support for the
  init
  parameter in service configurations
  Added support for extension fields in service, network, volume, secret,
  and config configurations
  Compose format version 2.4
  Added support for extension fields in service, network,
  and volume configurations
  Bug fixes
  Fixed a bug that prevented deployment with some Compose files when
  DOCKER_DEFAULT_PLATFORM
  was set
  Compose will no longer try to create containers or volumes with
  invalid starting characters
  Fixed several bugs that prevented Compose commands from working properly
  with containers created with an older version of Compose
  Fixed an issue with the output of
  docker-compose config
  with the
  --compatibility-mode
  flag enabled when the source file contains
  attachable networks
  Fixed a bug that prevented the
  gcloud
  credential store from working
  properly when used with the Compose binary on UNIX
  Fixed a bug that caused connection errors when trying to operate
  over a non-HTTPS TCP connection on Windows
  Fixed a bug that caused builds to fail on Windows if the Dockerfile
  was located in a subdirectory of the build context
  Fixed an issue that prevented proper parsing of UTF-8 BOM encoded
  Compose files on Windows
  Fixed an issue with handling of the double-wildcard (
  ) pattern in
  .dockerignore
  files when using
  docker-compose build
  Fixed a bug that caused auth values in legacy
  .dockercfg
  files to be ignored
  docker-compose build
  will no longer attempt to create image names starting with an invalid character
  (2018-05-03)
  Bug fixes
  Fixed a bug where the ip_range attribute in IPAM configs was prevented
  from passing validation
  (2018-04-27)
  Bug fixes
  In 1.21.0, we introduced a change to how project names are sanitized for
  internal use in resource names. This caused issues when manipulating an
  existing, deployed application whose name had changed as a result.
  This release properly detects resources using "legacy" naming conventions.
  Fixed an issue where specifying an in-context Dockerfile using an absolute
  path would fail despite being valid.
  Fixed a bug where IPAM option changes were incorrectly detected, preventing
  redeployments.
  Validation of v2 files now properly checks the structure of IPAM configs.
  Improved support for credentials stores on Windows to include binaries using
  extensions other than
  .exe
  . The list of valid extensions is determined by
  the contents of the
  PATHEXT
  environment variable.
  Fixed a bug where Compose would generate invalid binds containing duplicate
  elements with some v3.2 files, triggering errors at the Engine level during
  deployment.
  (2018-04-11)
  New features
  Compose file version 2.4
  Introduced version 2.4 of the
  docker-compose.yml
  specification.
  This version requires Docker Engine 17.12.0 or above.
  Added support for the
  platform
  parameter in service definitions.
  If supplied, the parameter is also used when performing build for the
  service.
  Compose file version 2.2 and up
  Added support for the
  cpu_rt_period
  cpu_rt_runtime
  parameters
  in service definitions (2.x only).
  Compose file version 2.1 and up
  Added support for the
  cpu_period
  parameter in service definitions
  (2.x only).
  Added support for the
  isolation
  parameter in service build configurations.
  Additionally, the
  isolation
  parameter in service definitions is used for
  builds as well if no
  build.isolation
  parameter is defined. (2.x only)
  All formats
  Added support for the
  --workdir
  flag in
  docker-compose exec
  Added support for the
  --compress
  flag in
  docker-compose build
  docker-compose pull
  is now performed in parallel by default. You can
  opt out using the
  --no-parallel
  flag. The
  --parallel
  flag is now
  deprecated and will be removed in a future version.
  Dashes and underscores in project names are no longer stripped out.
  docker-compose build
  now supports the use of Dockerfile from outside
  the build context.
  Bug fixes
  Compose now checks that the volume's configuration matches the remote
  volume, and errors out if a mismatch is detected.
  Fixed a bug that caused Compose to raise unexpected errors when attempting
  to create several one-off containers in parallel.
  Fixed a bug with argument parsing when using
  docker-machine config
  generate TLS flags for
  exec
  commands.
  Fixed a bug where variable substitution with an empty default value
  (e.g.
  ${VAR:-}
  ) would print an incorrect warning.
  Improved resilience when encoding of the Compose file doesn't match the
  system's. Users are encouraged to use UTF-8 when possible.
  Fixed a bug where external overlay networks in Swarm would be incorrectly
  recognized as inexistent by Compose, interrupting otherwise valid
  operations.
  (2018-03-20)
  New features
  Compose file version 3.6
  Introduced version 3.6 of the
  docker-compose.yml
  specification.
  This version must be used with Docker Engine 18.02.0 or above.
  Added support for the
  tmpfs.size
  property in volume mappings
  Compose file version 3.2 and up
  --build-arg
  option can now be used without specifying a service
  docker-compose build
  Compose file version 2.3
  Added support for
  device_cgroup_rules
  in service definitions
  Added support for the
  tmpfs.size
  property in long-form volume mappings
  --build-arg
  option can now be used without specifying a service
  docker-compose build
  All formats
  Added a
  --log-level
  option to the top-level
  docker-compose
  command.
  Accepted values are
  debug
  info
  warning
  error
  critical
  Default log level is
  info
  docker-compose run
  now allows users to unset the container's entrypoint
  Proxy configuration found in the
  ~/.docker/config.json
  file now populates
  environment and build args for containers created by Compose
  Added the
  --use-aliases
  flag to
  docker-compose run
  , indicating that
  network aliases declared in the service's config should be used for the
  running container
  Added the
  --include-deps
  flag to
  docker-compose pull
  docker-compose run
  now kills and removes the running container upon
  receiving
  SIGHUP
  docker-compose ps
  now shows the containers' health status if available
  Added the long-form
  --detach
  option to the
  exec
  commands
  Bug fixes
  Fixed
  .dockerignore
  handling, notably with regard to absolute paths
  and last-line precedence rules
  Fixed an issue where Compose would make costly DNS lookups when connecting
  to the Engine when using Docker For Mac
  Fixed a bug introduced in 1.19.0 which caused the default certificate path
  to not be honored by Compose
  Fixed a bug where Compose would incorrectly check whether a symlink's
  destination was accessible when part of a build context
  Fixed a bug where
  .dockerignore
  files containing lines of whitespace
  caused Compose to error out on Windows
  Fixed a bug where
  --tls*
  --host
  options wouldn't be properly honored
  for interactive
  exec
  commands
  seccomp:<filepath>
  entry in the
  security_opt
  config now correctly
  sends the contents of the file to the engine
  ANSI output for
  down
  operations should no longer affect the wrong
  lines
  Improved support for non-unicode locales
  Fixed a crash occurring on Windows when the user's home directory name
  contained non-ASCII characters
  Fixed a bug occurring during builds caused by files with a negative
  mtime
  values in the build context
  Fixed an encoding bug when streaming build progress
  (2018-02-07)
  Breaking changes
  On UNIX platforms, interactive
  exec
  commands now require
  docker
  CLI to be installed on the client by default. To revert
  to the previous behavior, users may set the
  COMPOSE_INTERACTIVE_NO_CLI
  environment variable.
  New features
  Compose file version 3.x
  The output of the
  config
  command should now merge
  deploy
  options from
  several Compose files in a more accurate manner
  Compose file version 2.3
  Added support for the
  runtime
  option in service definitions
  Compose file version 2.1 and up
  Added support for the
  ${VAR:?err}
  ${VAR?err}
  variable interpolation
  syntax to indicate mandatory variables
  Compose file version 2.x
  Added
  priority
  key to service network mappings, allowing the user to
  define in which order the specified service will connect to each network
  All formats
  Added
  --renew-anon-volumes
  (shorthand
  ) to the
  command,
  preventing Compose from recovering volume data from previous containers for
  anonymous volumes
  Added limit for number of simultaneous parallel operations, which should
  prevent accidental resource exhaustion of the server. Default is 64 and
  can be configured using the
  COMPOSE_PARALLEL_LIMIT
  environment variable
  Added
  --always-recreate-deps
  flag to the
  command to force recreating
  dependent services along with the dependency owner
  Added
  COMPOSE_IGNORE_ORPHANS
  environment variable to forgo orphan
  container detection and suppress warnings
  Added
  COMPOSE_FORCE_WINDOWS_HOST
  environment variable to force Compose
  to parse volume definitions as if the Docker host was a Windows system,
  even if Compose itself is currently running on UNIX
  Bash completion should now be able to better differentiate between running,
  stopped and paused services
  Bug fixes
  Fixed a bug that would cause the
  build
  command to report a connection
  error when the build context contained unreadable files or FIFO objects.
  These file types will now be handled appropriately
  Fixed various issues around interactive
  exec
  sessions.
  Fixed a bug where setting TLS options with environment and CLI flags
  simultaneously would result in part of the configuration being ignored
  Fixed a bug where the DOCKER_TLS_VERIFY environment variable was being
  ignored by Compose
  Fixed a bug where the
  --timeout
  flags in
  were erroneously
  marked as incompatible
  Fixed a bug where the recreation of a service would break if the image
  associated with the previous container had been removed
  Fixed a bug where updating a mount's target would break Compose when
  trying to recreate the associated service
  Fixed a bug where
  tmpfs
  volumes declared using the extended syntax in
  Compose files using version 3.2 would be erroneously created as anonymous
  volumes instead
  Fixed a bug where type conversion errors would print a stacktrace instead
  of exiting gracefully
  Fixed some errors related to unicode handling
  Dependent services no longer get recreated along with the dependency owner
  if their configuration hasn't changed
  Added better validation of
  labels
  fields in Compose files. Label values
  containing scalar types (number, boolean) now get automatically converted
  to strings
  (2017-12-18)
  New features
  Compose file version 3.5
  Introduced version 3.5 of the
  docker-compose.yml
  specification.
  This version requires Docker Engine 17.06.0 or above
  Added support for the
  shm_size
  parameter in build configurations
  Added support for the
  isolation
  parameter in service definitions
  Added support for custom names for network, secret and config definitions
  Compose file version 2.3
  Added support for
  extra_hosts
  in build configuration
  Added support for the
  long syntax
  for volume entries, as previously introduced in the 3.2 format.
  Using this syntax will create
  mounts
  instead of volumes.
  Compose file version 2.1 and up
  Added support for the
  oom_kill_disable
  parameter in service definitions
  (2.x only)
  Added support for custom names for network definitions (2.x only)
  All formats
  Values interpolated from the environment will now be converted to the
  proper type when used in non-string fields.
  Added support for
  --label
  docker-compose run
  Added support for
  --timeout
  docker-compose down
  Added support for
  --memory
  docker-compose build
  Setting
  stop_grace_period
  in service definitions now also sets the
  container's
  stop_timeout
  Bug fixes
  Fixed an issue where Compose was still handling service hostname according
  to legacy engine behavior, causing hostnames containing dots to be cut up
  Fixed a bug where the
  X-Y:Z
  syntax for ports was considered invalid
  by Compose
  Fixed an issue with CLI logging causing duplicate messages and inelegant
  output to occur
  Fixed an issue that caused
  stop_grace_period
  to be ignored when using
  multiple Compose files
  Fixed a bug that caused
  docker-compose images
  to crash when using
  untagged images
  Fixed a bug where the valid
  ${VAR:-}
  syntax would cause Compose to
  error out
  Fixed a bug where
  env_file
  entries using an UTF-8 BOM were being read
  incorrectly
  Fixed a bug where missing secret files would generate an empty directory
  in their place
  Fixed character encoding issues in the CLI's error handlers
  Added validation for the
  test
  field in healthchecks
  Added validation for the
  subnet
  field in IPAM configurations
  Added validation for
  volumes
  properties when using the long syntax in
  service definitions
  The CLI now explicit prevents using
  --timeout
  together
  docker-compose up
  (2017-11-01)
  New features
  Compose file version 3.4
  Introduced version 3.4 of the
  docker-compose.yml
  specification.
  This version requires to be used with Docker Engine 17.06.0 or above.
  Added support for
  cache_from
  network
  target
  options in build
  configurations
  Added support for the
  order
  parameter in the
  update_config
  section
  Added support for setting a custom name in volume definitions using
  name
  parameter
  Compose file version 2.3
  Added support for
  shm_size
  option in build configuration
  Compose file version 2.x
  Added support for extension fields (
  ). Also available for v3.4 files
  All formats
  Added new
  --no-start
  to the
  command, allowing users to create all
  resources (networks, volumes, containers) without starting services.
  create
  command is deprecated in favor of this new option
  Bug fixes
  Fixed a bug where
  extra_hosts
  values would be overridden by extension
  files instead of merging together
  Fixed a bug where the validation for v3.2 files would prevent using the
  consistency
  field in service volume definitions
  Fixed a bug that would cause a crash when configuration fields expecting
  unique items would contain duplicates
  Fixed a bug where mount overrides with a different mode would create a
  duplicate entry instead of overriding the original entry
  Fixed a bug where build labels declared as a list wouldn't be properly
  parsed
  Fixed a bug where the output of
  docker-compose config
  would be invalid
  for some versions if the file contained custom-named external volumes
  Improved error handling when issuing a build command on Windows using an
  unsupported file version
  Fixed an issue where networks with identical names would sometimes be
  created when running
  commands concurrently.
  (2017-08-31)
  New features
  Compose file version 2.3
  Introduced version 2.3 of the
  docker-compose.yml
  specification.
  This version requires to be used with Docker Engine 17.06.0 or above.
  Added support for the
  target
  parameter in build configurations
  Added support for the
  start_period
  parameter in healthcheck
  configurations
  Compose file version 2.x
  Added support for the
  blkio_config
  parameter in service definitions
  Added support for setting a custom name in volume definitions using
  name
  parameter (not available for version 2.0)
  All formats
  Added new CLI flag
  --no-ansi
  to suppress ANSI control characters in
  output
  Bug fixes
  Fixed a bug where nested
  extends
  instructions weren't resolved
  properly, causing "file not found" errors
  Fixed several issues with
  .dockerignore
  parsing
  Fixed issues where logs of TTY-enabled services were being printed
  incorrectly and causing
  MemoryError
  exceptions
  Fixed a bug where printing application logs would sometimes be interrupted
  by a
  UnicodeEncodeError
  exception on Python 3
  character in the output of
  docker-compose config
  is now
  properly escaped
  Fixed a bug where running
  docker-compose top
  would sometimes fail
  with an uncaught exception
  Fixed a bug where
  docker-compose pull
  with the
  --parallel
  flag
  would return a
  exit code when failing
  Fixed an issue where keys in
  deploy.resources
  were not being validated
  Fixed an issue where the
  logging
  options in the output of
  docker-compose config
  would be set to
  
  , an invalid value
  Fixed the output of the
  docker-compose images
  command when an image
  would come from a private repository using an explicit port number
  Fixed the output of
  docker-compose config
  when a port definition used
  as the value for the published port
  (2017-07-26)
  New features
  Compose file version 2.2
  Added support for the
  network
  parameter in build configurations.
  Compose file version 2.1 and up
  option in a service's definition now supports a
  service:<name>
  value.
  Added support for the
  storage_opt
  parameter in service definitions.
  This option is not available for the v3 format
  All formats
  Added
  --quiet
  flag to
  docker-compose pull
  , suppressing progress output
  Some improvements to CLI output
  Bug fixes
  Volumes specified through the
  --volume
  flag of
  docker-compose run
  complement volumes declared in the service's definition instead of replacing
  them
  Fixed a bug where using multiple Compose files would unset the scale value
  defined inside the Compose file.
  Fixed an issue where the
  credHelpers
  entries in the
  config.json
  file
  were not being honored by Compose
  Fixed a bug where using multiple Compose files with port declarations
  would cause failures in Python 3 environments
  Fixed a bug where some proxy-related options present in the user's
  environment would prevent Compose from running
  Fixed an issue where the output of
  docker-compose config
  would be invalid
  if the original file used
  values
  Fixed an issue preventing
  operations on a previously created stack on
  Windows Engine.
  (2017-06-19)
  New features
  Compose file version 3.3
  Introduced version 3.3 of the
  docker-compose.yml
  specification.
  This version requires to be used with Docker Engine 17.06.0 or above.
  Note: the
  credential_spec
  configs
  keys only apply to Swarm services
  and will be ignored by Compose
  Compose file version 2.2
  Added the following parameters in service definitions:
  cpu_count
  cpu_percent
  cpus
  Compose file version 2.1
  Added support for build labels. This feature is also available in the
  2.2 and 3.3 formats.
  All formats
  Added shorthand
  --user
  flag in
  docker-compose exec
  Differences in labels between the Compose file and remote network
  will now print a warning instead of preventing redeployment.
  Bug fixes
  Fixed a bug where service's dependencies were being rescaled to their
  default scale when running a
  docker-compose run
  command
  Fixed a bug where
  docker-compose rm
  with the
  --stop
  flag was not
  behaving properly when provided with a list of services to remove
  Fixed a bug where
  cache_from
  in the build section would be ignored when
  using more than one Compose file.
  Fixed a bug that prevented binding the same port to different IPs when
  using more than one Compose file.
  Fixed a bug where override files would not be picked up by Compose if they
  had the
  .yaml
  extension
  Fixed a bug on Windows Engine where networks would be incorrectly flagged
  for recreation
  Fixed a bug where services declaring ports would cause crashes on some
  versions of Python 3
  Fixed a bug where the output of
  docker-compose config
  would sometimes
  contain invalid port definitions
  (2017-05-02)
  Breaking changes
  docker-compose up
  now resets a service's scaling to its default value.
  You can use the newly introduced
  --scale
  option to specify a custom
  scale value
  New features
  Compose file version 2.2
  Introduced version 2.2 of the
  docker-compose.yml
  specification. This
  version requires to be used with Docker Engine 1.13.0 or above
  Added support for
  init
  in service definitions.
  Added support for
  scale
  in service definitions. The configuration's value
  can be overridden using the
  --scale
  flag in
  docker-compose up
  scale
  command is disabled for this file format
  Compose file version 2.x
  Added support for
  options
  in the
  ipam
  section of network definitions
  Bug fixes
  Fixed a bug where paths provided to compose via the
  option were not
  being resolved properly
  Fixed a bug where the
  ext_ip::target_port
  notation in the ports section
  was incorrectly marked as invalid
  Fixed an issue where the
  exec
  command would sometimes not return control
  to the terminal when using the
  flag
  Fixed a bug where secrets were missing from the output of the
  config
  command for v3.2 files
  Fixed an issue where
  docker-compose
  would hang if no internet connection
  was available
  Fixed an issue where paths containing unicode characters passed via the
  flag were causing Compose to crash
  Fixed an issue where the output of
  docker-compose config
  would be invalid
  if the Compose file contained external secrets
  Fixed a bug where using
  --exit-code-from
  with
  would fail if Compose
  was installed in a Python 3 environment
  Fixed a bug where recreating containers using a combination of
  tmpfs
  volumes
  would result in an invalid config state
  (2017-04-04)
  New features
  Compose file version 3.2
  Introduced version 3.2 of the
  docker-compose.yml
  specification
  Added support for
  cache_from
  in the
  build
  section of services
  Added support for the new expanded ports syntax in service definitions
  Added support for the new expanded volumes syntax in service definitions
  Compose file version 2.1
  Added support for
  pids_limit
  in service definitions
  Compose file version 2.0 and up
  Added
  --volumes
  option to
  docker-compose config
  that lists named
  volumes declared for that project
  Added support for
  mem_reservation
  in service definitions (2.x only)
  Added support for
  dns_opt
  in service definitions (2.x only)
  All formats
  Added a new
  docker-compose images
  command that lists images used by
  the current project's containers
  Added a
  --stop
  (shorthand
  ) option to
  docker-compose rm
  that stops
  the running containers before removing them
  Added a
  --resolve-image-digests
  option to
  docker-compose config
  that
  pins the image version for each service to a permanent digest
  Added a
  --exit-code-from SERVICE
  option to
  docker-compose up
  . When
  used,
  docker-compose
  will exit on any container's exit with the code
  corresponding to the specified service's exit code
  Added a
  --parallel
  option to
  docker-compose pull
  that enables images
  for multiple services to be pulled simultaneously
  Added a
  --build-arg
  option to
  docker-compose build
  Added a
  --volume <volume_mapping>
  (shorthand
  ) option to
  docker-compose run
  to declare runtime volumes to be mounted
  Added a
  --project-directory PATH
  option to
  docker-compose
  that will
  affect path resolution for the project
  When using
  --abort-on-container-exit
  docker-compose up
  , the exit
  code for the container that caused the abort will be the exit code of
  docker-compose up
  command
  Users can now configure which path separator character they want to use
  to separate the
  COMPOSE_FILE
  environment value using the
  COMPOSE_PATH_SEPARATOR
  environment variable
  Added support for port range to a single port in port mappings, such as
  8000-8010:80
  Bug fixes
  docker-compose run --rm
  now removes anonymous volumes after execution,
  matching the behavior of
  docker run --rm
  Fixed a bug where override files containing port lists would cause a
  TypeError to be raised
  Fixed a bug where the
  deploy
  key would be missing from the output of
  docker-compose config
  Fixed a bug where scaling services up or down would sometimes re-use
  obsolete containers
  Fixed a bug where the output of
  docker-compose config
  would be invalid
  if the project declared anonymous volumes
  Variable interpolation now properly occurs in the
  secrets
  section of
  the Compose file
  secrets
  section now properly appears in the output of
  docker-compose config
  Fixed a bug where changes to some networks properties would not be
  detected against previously created networks
  Fixed a bug where
  docker-compose
  would crash when trying to write into
  a closed pipe
  Fixed an issue where Compose would not pick up on the value of
  COMPOSE_TLS_VERSION when used in combination with command-line TLS flags
  (2017-02-17)
  Bug fixes
  Fixed a bug that was preventing secrets configuration from being
  loaded properly
  Fixed a bug where the
  docker-compose config
  command would fail
  if the config file contained secrets definitions
  Fixed an issue where Compose on some linux distributions would
  pick up and load an outdated version of the requests library
  Fixed an issue where socket-type files inside a build folder
  would cause
  docker-compose
  to crash when trying to build that
  service
  Fixed an issue where recursive wildcard patterns
  were not being
  recognized in
  .dockerignore
  files.
  (2017-02-09)
  Bug fixes
  Fixed a bug where the 3.1 file format was not being recognized as valid
  by the Compose parser
  (2017-02-08)
  New Features
  Compose file version 3.1
  Introduced version 3.1 of the
  docker-compose.yml
  specification. This
  version requires Docker Engine 1.13.0 or above. It introduces support
  for secrets. See the documentation for more information
  Compose file version 2.0 and up
  Introduced the
  docker-compose top
  command that displays processes running
  for the different services managed by Compose.
  Bug fixes
  Fixed a bug where extending a service defining a healthcheck dictionary
  would cause
  docker-compose
  to error out.
  Fixed an issue where the
  entry in a service definition was being
  ignored when using multiple Compose files.
  (2017-02-01)
  Bug fixes
  Fixed an issue where the presence of older versions of the docker-py
  package would cause unexpected crashes while running Compose
  Fixed an issue where healthcheck dependencies would be lost when
  using multiple compose files for a project
  Fixed a few issues that made the output of the
  config
  command
  invalid
  Fixed an issue where adding volume labels to v3 Compose files would
  result in an error
  Fixed an issue on Windows where build context paths containing unicode
  characters were being improperly encoded
  Fixed a bug where Compose would occasionally crash while streaming logs
  when containers would stop or restart
  (2017-01-18)
  New Features
  Compose file version 3.0
  Introduced version 3.0 of the
  docker-compo