1.7.0 RC1

Note that Compose 1.7.0 requires Docker Engine 1.10.0 or later for version 2 of the Compose File format, and Docker Engine 1.9.1 or later for version 1.

If you're a Mac or Windows user, the Docker Toolbox will install Compose 1.7.0 for you, alongside the latest versions of Docker Engine, Machine and Kitematic.

Alternatively, you can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.7.0-rc1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Here's what's new:

Breaking Changes

• docker-compose logs no longer follows log output by default. It now
  matches the behaviour of docker logs and exits after the current logs
  are printed. Use -f to get the old default behaviour.
• Booleans are no longer allows as values for mappings in the Compose file
  (for keys environment, labels and extra_hosts). Previously this
  was a warning. Boolean values should be quoted so they become string values.

New Features

• Compose now looks for a .env file in the directory where it's run and
  reads any environment variables defined inside, if they're not already
  set in the shell environment. This lets you easily set defaults for
  variables used in the Compose file, or for any of the COMPOSE_* or
  DOCKER_* variables.
• Added a --remove-orphans flag to both docker-compose up and
  docker-compose down to remove containers for services that were removed
  from the Compose file.
• Added a --all flag to docker-compose rm to include containers created
  by docker-compose run. This will become the default behavior in the next
  version of Compose.
• Added support for all the same TLS configuration flags used by the docker
  client: --tls, --tlscert, --tlskey, etc.
• Compose files now support the tmpfs and shm_size options.
• Added the --workdir flag to docker-compose run
• docker-compose logs now shows logs for new containers that are created
  after it starts.
• The COMPOSE_FILE environment variable can now contain multiple files,
  separated by the host system's standard path separator (: on Mac/Linux,
  ; on Windows).
• You can now specify a static IP address when connecting a service to a
  network with the ipv4_address and ipv6_address options.
• Added --follow, --timestamp, and --tail flags to the
  docker-compose logs command.
• docker-compose up, and docker-compose start will now start containers
  in parallel where possible.
• docker-compose stop now stops containers in reverse dependency order
  instead of all at once.
• Added the --build flag to docker-compose up to force it to build a new
  image. It now shows a warning if an image is automatically built when the
  flag is not used.
• Added the docker-compose exec command for executing a process in a running
  container.

Bug Fixes

• docker-compose down now removes containers created by
  docker-compose run.
• A more appropriate error is shown when a timeout is hit during up when
  using a tty.
• Fixed a bug in docker-compose down where it would abort if some resources
  had already been removed.
• Fixed a bug where changes to network aliases would not trigger a service
  to be recreated.
• Fix a bug where a log message was printed about creating a new volume
  when it already existed.
• Fixed a bug where interrupting up would not always shut down containers.
• Fixed a bug where log_opt and log_driver were not properly carried over
  when extending services in the v1 Compose file format.
• Fixed a bug where empty values for build args would cause file validation
  to fail.

Thanks @aanand, @shin-, @londoncalling, @albers, @seguins, @IlyaSkriblovsky, @cr7pt0gr4ph7, @clkao, @nubs, @moxiegirl, @AvdN, @yograterol, @TomasTomecek, @simonvanderveldt, @richardbann, @michael-k, @ltiao, @JesusTinoco, @humitos, @graingert, @flowrx, @dbonev, @bfirsh

1.6.2

Note that Compose 1.6.2 requires Docker Engine 1.9.1 or later, or 1.10.0 if you're using version 2 of the Compose File format (see https://docs.docker.com/compose/compose-file/#versioning).

If you're a Mac or Windows user, the Docker Toolbox will install Compose 1.6.2 for you, alongside the latest versions of Docker Engine, Machine and Kitematic.

Alternatively, you can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.6.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Bug Fixes

• Fixed a bug where connecting to a TLS-enabled Docker Engine would fail with a certificate verification error.

1.6.1

Note that Compose 1.6.1 requires Docker Engine 1.9.1 or later, or 1.10.0 if you're using version 2 of the Compose File format (see https://docs.docker.com/compose/compose-file/#versioning).

If you're a Mac or Windows user, the Docker Toolbox will install Compose 1.6.1 for you, alongside the latest versions of Docker Engine, Machine and Kitematic.

Alternatively, you can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.6.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Bug Fixes

• Fixed a bug where recreating a container multiple times would cause the new container to be started without the previous volumes.
• Fixed a bug where Compose would set the value of unset environment variables to an empty string, instead of a key without a value.
• Provide a better error message when Compose requires a more recent version of the Docker API.
• Add a missing config field network.aliases which allows setting a network scoped alias for a service.
• Fixed a bug where run would not start services listed in depends_on.
• Fixed a bug where networks and network_mode where not merged when using extends or multiple Compose files.
• Fixed a bug with service aliases where the short container id alias was only contained 10 characters, instead of the 12 characters used in previous versions.
• Added a missing log message when creating a new named volume.
• Fixed a bug where build.args was not merged when using extends or multiple Compose files.
• Fixed some bugs with config validation when null values or incorrect types were used instead of a mapping.
• Fixed a bug where a build section without a context would show a stack trace instead of a helpful validation error message.
• Improved compatibility with swarm by only setting a container affinity to the previous instance of a service's container when the service uses an anonymous container volume. Previously the affinity was always set on all containers.
• Fixed the validation of driver_opts would cause an error if a number was used instead of a string.
• Some improvements to the run.sh script used by the Compose container install option.
• Fixed a bug with up --abort-on-container-exit where Compose would exit, but would not stop other containers.
• Corrected the warning message that is printed when a boolean value is used as a value in a mapping.

Thanks @aanand, @shin-, @londoncalling, @sdurrheimer, @moxiegirl, @jrabbit, @cr7pt0gr4ph7, @nubs, @clkao, @dbonev, @AvdN, @albers

1.6.0

Note that Compose 1.6.0 requires Docker Engine 1.9.1 or later, or 1.10.0 if you're using version 2 of the Compose File format (see the changelog below).

If you're a Mac or Windows user, the Docker Toolbox will install Compose 1.6.0 for you, alongside the latest versions of Docker Engine, Machine and Kitematic.

Alternatively, you can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.6.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Major Features

• Compose 1.6 introduces a new format for docker-compose.yml which lets you define networks and volumes in the Compose file as well as services. It also makes a few changes to the structure of some configuration options.

You don't have to use it - your existing Compose files will run on Compose 1.6 exactly as they do today.

Check the upgrade guide for full details.

• Support for networking has exited experimental status and is the recommended way to enable communication between containers.

If you use the new file format, your app will use networking. If you aren't ready yet, just leave your Compose file as it is and it'll continue to work just the same.

By default, you don't have to configure any networks. In fact, using networking with Compose involves even less configuration than using links. Consult the networking guide for how to use it.

The experimental flags --x-networking and --x-network-driver, introduced in Compose 1.5, have been removed.

• You can now pass arguments to a build if you're using the new file format:

build:
  context: .
  args:
    buildno: 1

• You can now specify both a build and an image key if you're using the new file format. docker-compose build will build the image and tag it with the name you've specified, while docker-compose pull will attempt to pull it.
• There's a new events command for monitoring container events from the application, much like docker events. This is a good primitive for building tools on top of Compose for performing actions when particular things happen, such as containers starting and stopping.
• There's a new depends_on option for specifying dependencies between services. This enforces the order of startup, and ensures that when you run docker-compose up SERVICE on a service with dependencies, those are started as well.

New Features

• Added a new command config which validates and prints the Compose configuration after interpolating variables, resolving relative paths, and merging multiple files and extends.
• Added a new command create for creating containers without starting them.
• Added a new command down to stop and remove all the resources created by up in a single command.
• Added support for the cpu_quota configuration option.
• Added support for the stop_signal configuration option.
• Commands start, restart, pause, and unpause now exit with an error status code if no containers were modified.
• Added a new --abort-on-container-exit flag to up which causes up to stop all container and exit once the first container exits.
• Removed support for FIG_FILE, FIG_PROJECT_NAME, and no longer reads fig.yml as a default Compose file location.
• Removed the migrate-to-labels command.
• Removed the --allow-insecure-ssl flag.

Bug Fixes

• Fixed a validation bug that prevented the use of a range of ports in the expose field.
• Fixed a validation bug that prevented the use of arrays in the entrypoint field if they contained duplicate entries.
• Fixed a bug that caused ulimits to be ignored when used with extends.
• Fixed a bug that prevented ipv6 addresses in extra_hosts.
• Fixed a bug that caused extends to be ignored when included from multiple Compose files.
• Fixed an incorrect warning when a container volume was defined in the Compose file.
• Fixed a bug that prevented the force shutdown behaviour of up and logs.
• Fixed a bug that caused None to be printed as the network driver name when the default network driver was used.
• Fixed a bug where using the string form of dns or dns_search would cause an error.
• Fixed a bug where a container would be reported as "Up" when it was in the restarting state.
• Fixed a confusing error message when DOCKER_CERT_PATH was not set properly.
• Fixed a bug where attaching to a container would fail if it was using a non-standard logging driver (or none at all).
• Fixed a bug where some config options, such as links and ports, were not properly merged when using multiple Compose files.
• Fixed a bug where setting COMPOSE_PROJECT_NAME to an empty string would result in an empty project name, rather than falling back to the directory name.

Thanks @dnephin, @shin-, @sdurrheimer, @albers, @dbonev, @moxiegirl, @scipetr, @schmunk42, @rtlong, @nubs, @mustafau, @jzvelc, @hourliert, @gutweiler, @alf, @SvenDowideit and @garrettheel!

1.6.0 RC2

Note that Compose 1.6.0 requires Docker 1.9.1 or later.

If you're a Mac or Windows user, the Docker Toolbox will install Compose 1.6.0 for you, alongside the latest versions of the Docker Engine, Machine and Kitematic.

You can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.6.0-rc2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

On top of RC1's considerable list of changes, RC2 contains the following:

• links and external_links are now supported in the version 2 file format.
• Added the depends_on key for expressing dependencies between services without creating links.
• Added the network_mode key in the version 2 format as a replacement for version 1's net.
• Containers now join networks with an additional alias: a short version of the container id.
• Fixed a bug where multiple volumes (both prefixed with the project name and un-prefixed) would be created when a named volume was mounted into a service.
• Configuration under the networks key is now properly validated.
• Fixed a bug where containers started with docker-compose run didn't join networks defined for their service in docker-compose.yml.
• Fixed a docker-compose scale bug which would cause all containers to be removed if they exited immediately.
• Fixed a bug where extends didn't work in the version 2 format.
• Fixed "name is reserved" errors when running against Docker 1.10.0 RC1.
• Fixed a confusing error message when DOCKER_CERT_PATH was not set properly.
• Fixed a bug where attaching to a container would fail if it was using a non-standard logging driver (or none at all).
• Fixed various bugs with zsh completion.

Thanks @dnephin, @shin-, @sdurrheimer, @schmunk42, @jzvelc, @dbonev and @alf!

1.6.0 RC1

Note that Compose 1.6.0 requires Docker 1.9.0 or later.

If you're a Mac user, the Docker Toolbox will install Compose 1.6.0 for you, alongside the latest versions of the Docker Engine, Machine and Kitematic.

You can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.6.0-rc1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Major Features:

• Compose 1.6 introduces a new format for docker-compose.yml which lets
  you define networks and volumes in the Compose file as well as services. It
  also makes a few changes to the structure of some configuration options.

You don't have to use it - your existing Compose files will run on Compose
1.6 exactly as they do today.

See the Compose file reference for more information:
https://github.com/docker/compose/blob/1.6.0-rc1/docs/compose-file.md

• Support for networking has exited experimental status and is the recommended
  way to enable communication between containers.

If you use the new file format, your app will use networking. If you want to
keep using links, just leave your Compose file as it is and it'll continue
to work just the same.

By default, you don't have to configure any networks. In fact, using
networking with Compose involves even less configuration than using links.
Consult the networking guide for how to use it:
https://github.com/docker/compose/blob/1.6.0-rc1/docs/networking.md

The experimental flags --x-networking and --x-network-driver, introduced
in Compose 1.5, have been removed.

• You can now pass arguments to a build if you're using the new file format:

build:
  context: .
  args:
    buildno: 1

• You can now specify both a build and an image key if you're using the
  new file format. docker-compose build will build the image and tag it with
  the name you've specified, while docker-compose pull will attempt to pull
  it.
• There's a new events command for monitoring container events from
  the application, much like docker events. This is a good primitive for
  building tools on top of Compose for performing actions when particular
  things happen, such as containers starting and stopping.

New Features:

• Added a new command config which validates and prints the Compose
  configuration after interpolating variables, resolving relative paths, and
  merging multiple files and extends.
• Added a new command create for creating containers without starting them.
• Added a new command down to stop and remove all the resources created by
  up in a single command.
• Added support for the cpu_quota configuration option.
• Added support for the stop_signal configuration option.
• Commands start, restart, pause, and unpause now exit with an
  error status code if no containers were modified.
• Added a new --abort-on-container-exit flag to up which causes up to
  stop all container and exit once the first container exits.
• Removed support for FIG_FILE, FIG_PROJECT_NAME, and no longer reads
  fig.yml as a default Compose file location.
• Removed the migrate-to-labels command.
• Removed the --allow-insecure-ssl flag.

Bug Fixes:

• Fixed a validation bug that prevented the use of a range of ports in
  the expose field.
• Fixed a validation bug that prevented the use of arrays in the entrypoint
  field if they contained duplicate entries.
• Fixed a bug that caused ulimits to be ignored when used with extends.
• Fixed a bug that prevented ipv6 addresses in extra_hosts.
• Fixed a bug that caused extends to be ignored when included from
  multiple Compose files.
• Fixed an incorrect warning when a container volume was defined in
  the Compose file.
• Fixed a bug that prevented the force shutdown behaviour of up and
  logs.
• Fixed a bug that caused None to be printed as the network driver name
  when the default network driver was used.
• Fixed a bug where using the string form of dns or dns_search would
  cause an error.
• Fixed a bug where a container would be reported as "Up" when it was
  in the restarting state.

Thanks @aanand, @shin-, @dbonev, @albers, @vdemeester, @thaJeztah, @SvenDowideit, @seguins, @sdurrheimer, @moxiegirl, @TomasTomecek, @solarce, @simonvanderveldt, @scipetr, @punkstar, @jonaseck2, @jake-low, @hourliert, @gutweiler, @garrettheel

1.5.2

Note that Compose 1.5.2 requires Docker 1.7.1 or later.

If you're a Mac user, the Docker Toolbox will install Compose 1.5.2 for you, alongside the latest versions of the Docker Engine, Machine and Kitematic.

You can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.5.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Here's what's new:

• Fixed a bug which broke the use of environment and env_file with
  extends, and caused environment keys without values to have a None
  value, instead of a value from the host environment.
• Fixed a regression in 1.5.1 that caused a warning about volumes to be
  raised incorrectly when containers were recreated.
• Fixed a bug which prevented building a Dockerfile that used ADD <url>
• Fixed a bug with docker-compose restart which prevented it from
  starting stopped containers.
• Fixed handling of SIGTERM and SIGINT to properly stop containers
• Add support for using a url as the value of build
• Improved the validation of the expose option

Thanks @mnowster, @aanand, @viranch, @StefanScherer, @seguins, @simonvanderveldt, @jonaseck2

1.5.1

Note that Compose 1.5.1 requires Docker 1.7.1 or later.

If you're a Mac user, the Docker Toolbox will install Compose 1.5.1 for you, alongside the latest versions of the Docker Engine, Machine and Kitematic.

You can use the usual commands to install or upgrade:

curl -L https://github.com/docker/compose/releases/download/1.5.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Here's what's new:

• Add the --force-rm option to build.
• Add the ulimit option for services in the Compose file.
• Fixed a bug where up would error with "service needs to be built" if
  a service changed from using image to using build.
• Fixed a bug that would cause incorrect output of parallel operations
  on some terminals.
• Fixed a bug that prevented a container from being recreated when the
  mode of a volumes_from was changed.
• Fixed a regression in 1.5.0 where non-utf-8 unicode characters would cause
  up or logs to crash.
• Fixed a regression in 1.5.0 where Compose would use a success exit status
  code when a command fails due to an HTTP timeout communicating with the
  docker daemon.
• Fixed a regression in 1.5.0 where name was being accepted as a valid
  service option which would override the actual name of the service.
• When using --x-networking Compose no longer sets the hostname to the
  container name.
• When using --x-networking Compose will only create the default network
  if at least one container is using the network.
• When printing logs during up or logs, flush the output buffer after
  each line to prevent buffering issues from hiding logs.
• Recreate a container if one of it's dependencies is being created.
  Previously a container was only recreated if it's dependencies already
  existed, but were being recreated as well.
• Add a warning when a volume in the Compose file is being ignored
  and masked by a container volume from a previous container.
• Improve the output of pull when run without a tty.
• When using multiple Compose files, validate each before attempting to merge
  them together. Previously invalid files would result in not helpful errors.
• Allow dashes in keys in the environment service option.
• Improve validation error messages by including the filename as part of the
  error message.

Thanks @shin-, @mnowster, @aanand, @KevinGreene, @adrian-budau, @yvespp

1.5.0

This release contains breaking changes.

Note that Compose 1.5.0 requires Docker 1.7.1 or later.

If you're a Mac or Windows user, the Docker Toolbox will install Compose 1.5.0 for you, alongside the latest versions of the Docker Engine, Machine and Kitematic.

Otherwise, you can use the usual commands to install/upgrade. Either download the binary:

curl -L https://github.com/docker/compose/releases/download/1.5.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Or pip install -U docker-compose==1.5.0 if you prefer pip.

Here's what's new:

Breaking changes:

With the introduction of variable substitution support in the Compose file, any Compose file that uses an environment variable ($VAR or ${VAR}) in the command: or entrypoint: field will break.

Previously these values were interpolated inside the container, with a value from the container environment. In Compose 1.5.0, the values will be interpolated on the host, with a value from the host environment.

To migrate a Compose file to 1.5.0, escape the variables with an extra $ (ex: $$VAR or $${VAR}). See
https://github.com/docker/compose/blob/8cc8e61/docs/compose-file.md#variable-substitution

Major features:

• Compose is now available for Windows.
• Environment variables can be used in the Compose file. See
  https://github.com/docker/compose/blob/129092b7/docs/yml.md#variable-substitution
• Multiple compose files can be specified, allowing you to override settings in the default Compose file. See https://github.com/docker/compose/blob/129092b7/docs/reference/docker-compose.md for more details.
• Compose now produces better error messages when a file contains invalid configuration.
• up now waits for all services to exit before shutting down, rather than shutting down as soon as one container exits.
• Experimental support for the new docker networking system can be enabled with the --x-networking flag. Read more here: https://github.com/docker/docker/blob/8fee1c20/docs/userguide/dockernetworks.md

New features:

• You can now optionally pass a mode to volumes_from, e.g. volumes_from: ["servicename:ro"].
• Since Docker now lets you create volumes with names, you can refer to those volumes by name in docker-compose.yml. For example, volumes: ["mydatavolume:/data"] will mount the volume named mydatavolume at the path /data inside the container.

If the first component of an entry in volumes starts with a ., / or ~, it is treated as a path and expansion of relative paths is performed as necessary. Otherwise, it is treated as a volume name and passed straight through to Docker.

Read more on named volumes and volume drivers here:
https://github.com/docker/docker/blob/244d9c33/docs/userguide/dockervolumes.md

• docker-compose build --pull instructs Compose to pull the base image for each Dockerfile before building.
• docker-compose pull --ignore-pull-failures instructs Compose to continue if it fails to pull a single service's image, rather than aborting.
• You can now specify an IPC namespace in docker-compose.yml with the ipc option.
• Containers created by docker-compose run can now be named with the --name flag.
• If you install Compose with pip or use it as a library, it now works with Python 3.
• image now supports image digests (in addition to ids and tags), e.g.
  image: "busybox@sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b52004ee8502d"
• ports now supports ranges of ports, e.g.

ports:
  - "3000-3005"
  - "9000-9001:8000-8001"

• docker-compose run now supports a -p|--publish parameter, much like docker run -p, for publishing specific ports to the host.
• docker-compose pause and docker-compose unpause have been implemented, analogous to docker pause and docker unpause.
• When using extends to copy configuration from another service in the same Compose file, you can omit the file option.
• Compose can be installed and run as a Docker image. This is an experimental feature.

Bug fixes:

• All values for the log_driver option which are supported by the Docker daemon are now supported by Compose.
• docker-compose build can now be run successfully against a Swarm cluster.

Thanks @mnowster, @aanand, @moxiegirl, @albers, @mrfuxi, @viranch, @sdurrheimer, @charleswhchan, @ZJaffee, @villlem, @vdemeester, @TomasTomecek, @timbutler, @ticosax, @SvenDowideit, @stedur, @ronen, @md2perpe, @ggtools, @geron, @cweagans and @au-phiware!

1.5.0 RC3

This is a release candidate for version 1.5.0 of Compose.

Note that Compose 1.5.0 requires Docker 1.8.0 or later.

To try it out, run the following commands:

curl -L https://github.com/docker/compose/releases/download/1.5.0rc3/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Or pip install -U docker-compose==1.5.0rc3 if you prefer pip.

This release contains breaking changes.

Here's what's new:

Breaking changes:

With the introduction of variable substitution support in the Compose file, any
Compose file that uses an environment variable ($VAR or ${VAR}) in the command:
or entrypoint: field will break.

Previously these values were interpolated inside the container, with a value
from the container environment. In Compose 1.5.0, the values will be
interpolated on the host, with a value from the host environment.

To migrate a Compose file to 1.5.0, escape the variables with an extra $
(ex: $$VAR or $${VAR}). See
https://github.com/docker/compose/blob/8cc8e61/docs/compose-file.md#variable-substitution

Major features:

• Compose is now available for Windows.
• Environment variables can be used in the Compose file. See
  https://github.com/docker/compose/blob/129092b7/docs/yml.md#variable-substitution
• Multiple compose files can be specified, allowing you to override
  settings in the default Compose file. See
  https://github.com/docker/compose/blob/129092b7/docs/reference/docker-compose.md
  for more details.
• Compose now produces better error messages when a file contains
  invalid configuration.
• up now waits for all services to exit before shutting down,
  rather than shutting down as soon as one container exits.
• Experimental support for the new docker networking system can be
  enabled with the --x-networking flag. Read more here:
  https://github.com/docker/docker/blob/8fee1c20/docs/userguide/dockernetworks.md

New features:

• You can now optionally pass a mode to volumes_from, e.g.
  volumes_from: ["servicename:ro"].
• Since Docker now lets you create volumes with names, you can refer to those
  volumes by name in docker-compose.yml. For example,
  volumes: ["mydatavolume:/data"] will mount the volume named
  mydatavolume at the path /data inside the container.

If the first component of an entry in volumes starts with a ., / or
~, it is treated as a path and expansion of relative paths is performed as
necessary. Otherwise, it is treated as a volume name and passed straight
through to Docker.

Read more on named volumes and volume drivers here:
https://github.com/docker/docker/blob/244d9c33/docs/userguide/dockervolumes.md

• docker-compose build --pull instructs Compose to pull the base image for
  each Dockerfile before building.
• docker-compose pull --ignore-pull-failures instructs Compose to continue
  if it fails to pull a single service's image, rather than aborting.
• You can now specify an IPC namespace in docker-compose.yml with the ipc
  option.
• Containers created by docker-compose run can now be named with the
  --name flag.
• If you install Compose with pip or use it as a library, it now works with
  Python 3.
• image now supports image digests (in addition to ids and tags), e.g.
  image: "busybox@sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b52004ee8502d"
• ports now supports ranges of ports, e.g.

ports:
  - "3000-3005"
  - "9000-9001:8000-8001"

• docker-compose run now supports a -p|--publish parameter, much like
  docker run -p, for publishing specific ports to the host.
• docker-compose pause and docker-compose unpause have been implemented,
  analogous to docker pause and docker unpause.
• When using extends to copy configuration from another service in the same
  Compose file, you can omit the file option.
• Compose can be installed and run as a Docker image. This is an experimental
  feature.

Bug fixes:

• All values for the log_driver option which are supported by the Docker
  daemon are now supported by Compose.
• docker-compose build can now be run successfully against a Swarm cluster.

Thanks @mnowster, @aanand, @moxiegirl, @albers, @mrfuxi, @viranch, @sdurrheimer, @charleswhchan, @ZJaffee, @villlem, @vdemeester, @TomasTomecek, @timbutler, @ticosax, @SvenDowideit, @stedur, @ronen, @md2perpe, @ggtools, @geron, @cweagans, @au-phiware