docker-compose

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.6	18.02.0+
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.4	17.12.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 and 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 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.

Bugfixes

• 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 to generate TLS flags for exec and run 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.

Thanks to @mnottale, @g0t4, @dnephin, @dakotahawkins, @brainlock and @albers for contributing to this release!

Integrity check

SHA-256 sum	Binary name
82c690090293a721b6c84dcdc08c13256cca1816fa4a6c2f1676418bae71d3cb	docker-compose-Darwin-x86_64
db6990617d550aa7126217bb00f3041da58ef1eeeb5d902a8833fea07b66490a	docker-compose-Linux-x86_64
4e3bacebc8922a3ad09156473bb3d82c10faa56264ad3b1c0a4893460b347c4d	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.6	18.02.0+
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Bugfixes

• Fixed an issue where docker-compose build would error out if the build context contained directory symlinks

Integrity check

SHA-256 sum	Binary name
4a7a03b6184558f1efe962b47dbc489412ce5de4c420a3e116aaae6e03a140d3	docker-compose-Darwin-x86_64
11a6923c2a589b946598fe205c8f645e57f3f4ee153d3b7315b7e1993c1b2ad1	docker-compose-Linux-x86_64
ac40acdfa6283aabc1ca4b57ce8d0241fbe1f71409714ce0f357d1ea7624496d	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.6	18.02.0+
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 3.6

• Introduced version 3.6 of the docker-compose.yml specification. This version requires to 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

• The --build-arg option can now be used without specifying a service in 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

• The --build-arg option can now be used without specifying a service in 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, run and up commands

Bugfixes

• 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* and --host options wouldn't be properly honored for interactive run and exec commands

• A seccomp:<filepath> entry in the security_opt config now correctly sends the contents of the file to the engine

• ANSI output for up and 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

Thanks to @mnottale, @mefyl, @albers, @pantuza, @kcboschert, @jsdalton, @ghsatpute, @geigerzaehler, @garribas, @dihmuzikien, @d2s, @briandealwis and @artagnon for contributing to this release!

Integrity check

SHA-256 sum | Binary name 500f9ab56a76af04d9cd2ed1b953f8b663a9a212b9955d44536743e9200bcbd4 | docker-compose-Darwin-x86_64 3099f4087251c06e8d693877adb571365fcdf0819eeaa6ed37097978d2c50e83 | docker-compose-Linux-x86_64 587b41a75271ed37dd27b482a379844a296f92bde856cfad9068c17864c37393 | docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.6	18.02.0+
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 3.6

• Introduced version 3.6 of the docker-compose.yml specification. This version requires to 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

• The --build-arg option can now be used without specifying a service in 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

• The --build-arg option can now be used without specifying a service in 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, run and up commands

Bugfixes

• 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* and --host options wouldn't be properly honored for interactive run and exec commands

• A seccomp:<filepath> entry in the security_opt config now correctly sends the contents of the file to the engine

• ANSI output for up and 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

Thanks to @mnottale, @mefyl, @albers, @pantuza, @kcboschert, @jsdalton, @ghsatpute, @geigerzaehler, @garribas, @dihmuzikien, @d2s, @briandealwis and @artagnon for contributing to this release!

Integrity check

SHA-256 sum	Binary name
069f4078e37e7703353f7f8fe77216f7433654f3f7890cc702058693fb9502e3	docker-compose-Darwin-x86_64
3d59b1ce1ecee52e200bd375c6d0309f42ed59dc7bdac1658d67ff088c04cf7d	docker-compose-Linux-x86_64
221561892c2153648466de5f647fefcceeb78188e7bc71a52ec0999f8acc50d9	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.6	18.02.0+
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 3.6

• Introduced version 3.6 of the docker-compose.yml specification. This version requires to 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

• The --build-arg option can now be used without specifying a service in 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

• The --build-arg option can now be used without specifying a service in 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, run and up commands

Bugfixes

• Fixed .dockerignore handling, notably with regard to absolute paths and last-line precedence rules

• 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* and --host options wouldn't be properly honored for interactive run and exec commands

• A seccomp:<filepath> entry in the security_opt config now correctly sends the contents of the file to the engine

• 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

Thanks to @mnottale, @mefyl, @albers, @pantuza, @kcboschert, @jsdalton, @ghsatpute, @geigerzaehler, @garribas, @dihmuzikien, @d2s, @briandealwis and @artagnon for contributing to this release!

Integrity check

SHA-256 sum	Binary name
bdb0f8dec9815ba562246d398a8854d7fbd23e233cac88a6f9c58553c56e4cc4	docker-compose-Darwin-x86_64
91632399be7dbb106d8eae7dff91b11df6c117738e9cf25e1ece4920aa469ac4	docker-compose-Linux-x86_64
75da9357a69a64c2e4d22d3c47ac82574f371f2587a0c140ee814eb03747979b	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Breaking changes

• On UNIX platforms, interactive run and exec commands now require the 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} and ${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 -V) to the up command, preventing Compose from recovering volume data from previous containers for anonymous volumes

• Added limit for number of simulatenous 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 up 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

Bugfixes

• 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 run/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 -d and --timeout flags in up 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

Thanks to @DrewRomanyk, @garribas, @albers, @ilinum, @zaldaroga, @Dahca, @carlwgeorge, @ashmrtn, @tvanro, @thomascrha, @Rozelette, @mtsmfm, @johnharris85 and @d2s for contributing to this release!

Integrity check

SHA-256 sum	Binary name
e3c802584bf40eb3e92ac082f3d3217d940c234b80b686510ede977c90d0715e	docker-compose-Darwin-x86_64
78734996d716113f9f9716d0b5064166e9475835e5000fd01b0480d19e1f7372	docker-compose-Linux-x86_64
52bb70f8909c329133239621edfab470ea8c73525ea75b138b933190f8f5a0dd	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Breaking changes

• On UNIX platforms, interactive run and exec commands now require the 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} and ${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 -V) to the up command, preventing Compose from recovering volume data from previous containers for anonymous volumes

• Added limit for number of simulatenous 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 up 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

Bugfixes

• 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 run/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 -d and --timeout flags in up 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

Thanks to @DrewRomanyk, @garribas, @albers, @ilinum, @zaldaroga, @Dahca, @carlwgeorge, @ashmrtn, @tvanro, @thomascrha, @Rozelette, @mtsmfm and @johnharris85 for contributing to this release!

Integrity check

SHA-256 sum	Binary name
7762cda0cc711171a59db8ddc53ab0aa0a8f4f901deb306a9af6b68ac67ef2d3	docker-compose-Darwin-x86_64
38ce33de57287aed8b32997f0b68d15efea2f90b41ea592d2f4521d6c2af71d6	docker-compose-Linux-x86_64
ed4f5ebe0066dd4c313dbf3047d4b5ff78d908f16a1965bc15895eb4c188a622	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Breaking changes

• On UNIX platforms, interactive run and exec commands now require the 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} and ${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 -V) to the up command, preventing Compose from recovering volume data from previous containers for anonymous volumes

• Added limit for number of simulatenous 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 up 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

Bugfixes

• 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 run/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 -d and --timeout flags in up 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

Thanks to @DrewRomanyk, @garribas, @albers, @ilinum, @zaldaroga, @Dahca, @carlwgeorge, @ashmrtn, @tvanro, @thomascrha, @Rozelette, @mtsmfm and @johnharris85 for contributing to this release!

Integrity check

SHA-256 sum	Binary name
e1748116c25a53a336eccc570a1fd5c2c0678e6160c01fda8bbb789684d527fb	docker-compose-Darwin-x86_64
747a51307f7acf4145323e6faf022cbdfe802d89887bcdf0ce80eb606af25b43	docker-compose-Linux-x86_64
5f46c14ecec637687474ee6c5a36de51f42783f5b3f41e4fb7a27f13630fc6b6	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Breaking changes

• On UNIX platforms, interactive run and exec commands now require the 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} and ${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 -V) to the up command, preventing Compose from recovering volume data from previous containers for anonymous volumes

• Added limit for number of simulatenous 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 up 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

Bugfixes

• 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 run/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 -d and --timeout flags in up 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 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

Thanks to @DrewRomanyk, @garribas, @albers, @ilinum, @zaldaroga, @Dahca, @carlwgeorge, @ashmrtn, @tvanro, @thomascrha, @Rozelette, @mtsmfm and @johnharris85 for contributing to this release!

Integrity check

SHA-256 sum	Binary name
4ebaa6ef8fd182ee92169e25bb76f721f12331adefebbe44a04c58d1251fed6d	docker-compose-Darwin-x86_64
f5a5057f71f6cf44718625381346cce79806e41ad6bfe1f98e76cf4e4c861188	docker-compose-Linux-x86_64
1f2dfdd2502f812034b3d87bde45afc1c768b388977925dfbc9ad87758f8a90e	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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. Note that 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 in docker-compose run

• Added support for --timeout in docker-compose down

• Added support for --memory in docker-compose build

• Setting stop_grace_period in service definitions now also sets the container's stop_timeout

Bugfixes

• 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 -d and --timeout together in docker-compose up

Thanks to @garribas, @DrewRomanyk, @summergirl21, @AlexeyRokhin, @smiller123, @andyneff, @reutsharabani, @NikitaVlaznev, @mtsmfm, @jbarciauskas, @edsrzf and @albers for contributing to this release!

Integrity check

SHA-256 sum	Binary name
c8961b6751a0f809d8a22c2bd4a93fc0250dbd032f98b67380370d9288a894c0	docker-compose-Darwin-x86_64
b2f2c3834107f526b1d9cc8d8e0bdd132c6f1495b036a32cbc61b5288d2e2a01	docker-compose-Linux-x86_64
9c110e69aac18364f1fb10c99d26318096ebc4cf4bf5fe7931a38cac61b2eb45	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 3.5

• Introduced version 3.5 of the docker-compose.yml specification. This version requires to be used with 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. Note that 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 in docker-compose run

• Added support for --timeout in docker-compose down

• Added support for --memory in docker-compose build

• Setting stop_grace_period in service definitions now also sets the container's stop_timeout

Bugfixes

• 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 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

• 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 -d and --timeout together in docker-compose up

Thanks to @garribas, @DrewRomanyk, @summergirl21, @AlexeyRokhin, @smiller123, @andyneff, @reutsharabani, @NikitaVlaznev, @mtsmfm, @jbarciauskas, @edsrzf and @albers for contributing to this release!

Integrity check

SHA-256 sum	Binary name
75524159716f6f3bb497bffa8dfabc0434a05791464b5a152e1f91df228fb42a	docker-compose-Darwin-x86_64
d0e1ba02c67d83c7d1126eed4573d8b0063b9c07cdcea513092e6236ac2119c4	docker-compose-Linux-x86_64
1ffd46e90b39f27e256496b5f7128487099ed026784dc0777ec1bd60d7ac21e4	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.5	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 3.5

• Introduced version 3.5 of the docker-compose.yml specification. This version requires to be used with 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. Note that 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, secret and config 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 in docker-compose run

• Added support for --timeout in docker-compose down

• Added support for --memory in docker-compose build

• Setting stop_grace_period in service definitions now also sets the container's stop_timeout

Bugfixes

• 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 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

• 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 -d and --timeout together in docker-compose up

Thanks to @garribas, @DrewRomanyk, @summergirl21, @AlexeyRokhin, @smiller123, @andyneff, @reutsharabani, @NikitaVlaznev, @mtsmfm, @jbarciauskas and @edsrzf for contributing to this release!

Integrity check

SHA-256 sum	Binary name
e942bb42e6afa98b8045d4e43c7dfeb5c9b5a044070c9c43811a994f1a4a253c	docker-compose-Darwin-x86_64
08e11bae2565bf7f52c2f84a984683f64b60349e9a7e3b396dfe21acd38efc2e	docker-compose-Linux-x86_64
5144111a922e0586fa7bd83fe8df84156d41ecad15599b7045f4371f1b338743	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.4	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Bugfixes

• Fixed a bug that would prevent creating new containers when using container labels in the list format as part of the service's definition.

Integrity check

SHA-256 sum	Binary name
63de322e15539cf30d632758fc5339b60f32eb937ec17b4595a6a34b9d84484a	docker-compose-Darwin-x86_64
db0a7b79d195dc021461d5628a8d53eeb2e556d2548b764770fccabb0a319dd8	docker-compose-Linux-x86_64
86a9e5193628e93ab73fd0b7438e954f25ae68da45ab3b6ab10dda3f307bb21c	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

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

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.4	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 and 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 the 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 (x-*). Also available for v3.4 files

All formats

• Added new --no-start to the up command, allowing users to create all resources (networks, volumes, containers) without starting services. The create command is deprecated in favor of this new option

Bugfixes

• 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 up commands concurrently.

Thanks to @AlexeyRokhin, @garribas, @FrenchBen, @vdemeester, @NikitaVlaznev, @jbarciauskas, @hoogenm, @edsrzf, @AndreaGiardini, @andrewhsu and @albers for contributing to this release!

Integrity check

SHA-256 sum	Binary name
d4530830357dbf6fc6b933b6ffaf8bd28fafdeb5e2a01e8afa8746c55ba97b29	docker-compose-Darwin-x86_64
b553025b82fc61547933f05693716c92967b835979ba9b092b31e50bd35e30c9	docker-compose-Linux-x86_64
35a3365f403dbedb175d6c0f7d971bd497fa64915d44442aa694c732f454ad94	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.17.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.4	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 and 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 the 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 (x-*). Also available for v3.4 files

All formats

• Added new --no-start to the up command, allowing users to create all resources (networks, volumes, containers) without starting services. The create command is deprecated in favor of this new option

Bugfixes

• 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 up commands concurrently.

Thanks to @AlexeyRokhin, @garribas, @FrenchBen, @vdemeester, @NikitaVlaznev, @jbarciauskas, @hoogenm, @edsrzf, @andrewhsu and @AndreaGiardini for contributing to this release!

Integrity check

SHA sum	Binary name
89e1db7a926d4b56ac9e2ae0133a6e279424e87e	docker-compose-Darwin-x86_64
27f3648e33ee5c8f68c1d05c9e51a5b6669f94bd	docker-compose-Linux-x86_64
4651ab956f1ca6ca4d575af6fd72a011dad82d16	docker-compose-Windows-x86_64.exe

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.16.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Bugfixes

• Fixed bug that prevented using extra_hosts in several configuration files.

Thanks to @shin-, @andrewhsu and @seemethere for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.16.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 network 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 the name parameter (not available for version 2.0)

All formats

• Added new CLI flag --no-ansi to suppress ANSI control characters in output

Bugfixes

• 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

• The $ 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 0 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 null, 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 0 as the value for the published port

Thanks to @cecton, @albers, @lawliet89, @AlexeyRokhin, @NikitaVlaznev, @kirinrastogi, @jbarciauskas, @edsrzf and @carlwgeorge for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.16.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 network 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 the name parameter (not available for version 2.0)

All formats

• Added new CLI flag --no-ansi to suppress ANSI control characters in output

Bugfixes

• 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

• The $ 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 0 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 null, 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 0 as the value for the published port

Thanks to @cecton, @albers, @lawliet89, @AlexeyRokhin, @NikitaVlaznev, @kirinrastogi, @jbarciauskas, @edsrzf and @carlwgeorge for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.16.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3 – 3.4	17.06.0+
3.0 – 3.2	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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.

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 network configurations (also available in 3.4)

• 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 the name parameter (not available for version 2.0)

All formats

• Added new CLI flag --no-ansi to suppress ANSI control characters in output

Bugfixes

• 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

• The $ 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 0 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 null, an invalid value

• Fixed the output of docker-compose config when a port definition used 0 as the value for the published port

Thanks to @lawliet89, @AlexeyRokhin, @NikitaVlaznev, @kirinrastogi, @jbarciauskas, @edsrzf, @cecton, @carlwgeorge and @albers for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.15.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 2.2

• Added support for the network parameter in build configurations.

Compose file version 2.1 and up

• The pid option in a service's definition now supports a service:<name> value.

• Added support for the storage_opt parameter in 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

Bugfixes

• Volumes specified through the --volume flag of docker-compose run now complement volumes declared in the service's defintion 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 Y or N values

• Fixed an issue preventing up operations on a previously created stack on Windows Engine.

Thanks to @AlexeyRokhin, @edsrzf, @NikitaVlaznev, @jbarciauskas, @thaJeztah, @protoss-player, @kirinrastogi, @IPv4v6, @Dineshs91, @ColinHebert and @andyneff for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.15.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

New features

Compose file version 2.2

• Added support for the network parameter in build configurations.

Compose file version 2.1 and up

• The pid option in a service's definition now supports a service:<name> value.

• Added support for the storage_opt parameter in 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

Bugfixes

• Volumes specified through the --volume flag of docker-compose run now complement volumes declared in the service's defintion 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 Y or N values

Thanks to @edsrzf, @AlexeyRokhin, @thaJeztah, @protoss-player, @NikitaVlaznev, @jbarciauskas, @IPv4v6, @Dineshs91, @ColinHebert and @andyneff for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.14.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 and 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 -u for --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.

Bugfixes

• 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 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

Thanks to @AlexeyRokhin, @ColinHebert, @eliat123, @albers, @wrfly, @swoopla, @mengskysama, @londoncalling, @friism and @brainnwaveDuncan for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.14.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 and 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 -u for --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.

Bugfixes

• 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 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

Thanks to @AlexeyRokhin, @ColinHebert, @eliat123, @albers, @wrfly, @swoopla, @mengskysama, @londoncalling, @friism and @brainnwaveDuncan for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.14.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.3	17.06.0+
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 key only applies 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 -u for --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.

Bugfixes

• 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 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

Thanks to @AlexeyRokhin, @ColinHebert, @eliat123, @albers, @wrfly, @swoopla, @mengskysama, @londoncalling, @friism and @brainnwaveDuncan for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.13.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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. Please note that the scale command is disabled for this file format

Compose file version 2.x

• Added support for options in the ipam section of network definitions

Bugfixes

• Fixed a bug where paths provided to compose via the -f 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 -d 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 -f 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 up would fail if Compose was installed in a Python 3 environment

• Fixed a bug where recreating containers using a combination of tmpfs and volumes would result in an invalid config state

Thanks to @sdurrheimer, @albers, @kinghuang, @fate-grand-order and @brainnwaveDuncan for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.13.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 – 3.2	1.13.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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. Please note that the scale command is disabled for this file format

Compose file version 2.x

• Added support for options in the ipam section of network definitions

Bugfixes

• Fixed a bug where paths provided to compose via the -f 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 -d 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 -f flag were causing Compose to crash

Thanks to @sdurrheimer, @albers, @kinghuang and @fate-grand-order for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.12.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 – 3.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 -s) 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 -v) 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 in docker-compose up, the exit code for the container that caused the abort will be the exit code of the 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 single port in port mappings (e.g. 8000-8010:80)

Bugfixes

• 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 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

• The 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

Thanks to @albers, @edsrzf, @kinghuang, @sdurrheimer, @null, @dnephin, @xulike666, @jyapayne, @tcc-jenkins, @JesusTinoco, @jcberthon, @fate-grand-order, @Vehsamrak, @rawkode, @pts-kevinqiu, @nkovacs, @nbarbey, @milin, @melkor217, @marcosnils, @lindt, @Knetic, @kevinetc123, @hholst80, @eddwardo, @dguo, @dbonev, @dattran-vn01, @bheesham and @allandequeiroz for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.12.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 – 3.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 -s) 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 -v) 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 in docker-compose up, the exit code for the container that caused the abort will be the exit code of the 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 single port in port mappings (e.g. 8000-8010:80)

Bugfixes

• 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 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

• The 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

Thanks to @edsrzf, @albers, @kinghuang, @dnephin, @xulike666, @jyapayne, @tcc-jenkins, @JesusTinoco, @jcberthon, @Vehsamrak, @rawkode, @pts-kevinqiu, @nkovacs, @nbarbey, @milin, @melkor217, @marcosnils, @lindt, @Knetic, @kevinetc123, @hholst80, @fate-grand-order, @eddwardo, @dguo, @dbonev, @dattran-vn01, @bheesham and @allandequeiroz for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.12.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 ; 3.1	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

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 -s) 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 -v) 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 in docker-compose up, the exit code for the container that caused the abort will be the exit code of the 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 single port in port mappings (e.g. 8000-8010:80)

Bugfixes

• 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 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

• The 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

Thanks to @edsrzf, @albers, @kinghuang, @dnephin, @xulike666, @jyapayne, @tcc-jenkins, @JesusTinoco, @jcberthon, @Vehsamrak, @rawkode, @pts-kevinqiu, @nkovacs, @nbarbey, @milin, @melkor217, @marcosnils, @lindt, @Knetic, @kevinetc123, @hholst80, @fate-grand-order, @eddwardo, @dguo, @dbonev, @dattran-vn01, @bheesham, @allandequeiroz for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.11.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 ; 3.1	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Bugfixes

• 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.

Thanks to @dnephin for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.11.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 ; 3.1	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Changes

Bugfixes

• Fixed a bug where the 3.1 file format was not being recognized as valid by the Compose parser

Thanks to @dnephin for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.11.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 ; 3.1	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

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.

Bugfixes

• Fixed a bug where extending a service defining a healthcheck dictionary would cause docker-compose to error out.
• Fixed an issue where the pid entry in a service definition was being ignored when using multiple Compose files.

Thanks to @dnephin, @mattjbray, @xulike666, @urda, @tntC4stl3, @pts-kevinqiu, @muicoder, @graingert, @ankon for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.11.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0 ; 3.1	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

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.

Bugfixes

• Fixed a bug where extending a service defining a healthcheck dictionary would cause docker-compose to error out.
• Fixed an issue where the pid entry in a service definition was being ignored when using multiple Compose files.

Thanks to @dnephin, @mattjbray, @xulike666, @urda, @tntC4stl3, @pts-kevinqiu, @muicoder, @graingert, @ankon for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.10.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Latest changes

Bugfixes

• Fixed an issue where 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

Thanks to @dnephin for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.10.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.

Compose file format compatibility matrix

Compose file format	Docker Engine
3.0	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

Latest changes

New Features

Compose file version 3.0

• Introduced version 3.0 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.13 or above and is specifically designed to work with the docker stack commands.

Compose file version 2.1 and up

• Healthcheck configuration can now be done in the service definition using the healthcheck parameter
• Containers dependencies can now be set up to wait on positive healthchecks when declared using depends_on. See the documentation for the updated syntax. Note: This feature will not be ported to version 3 Compose files.
• Added support for the sysctls parameter in service definitions
• Added support for the userns_mode parameter in service definitions
• Compose now adds identifying labels to networks and volumes it creates

Compose file version 2.0 and up

• Added support for the stop_grace_period option in service definitions.

Bugfixes

• Colored output now works properly on Windows.
• Fixed a bug where docker-compose run would fail to set up link aliases in interactive mode on Windows.
• Networks created by Compose are now always made attachable (Compose files v2.1 and up).
• Fixed a bug where falsy values of COMPOSE_CONVERT_WINDOWS_PATHS (0, false, empty value) were being interpreted as true.
• Fixed a bug where forward slashes in some .dockerignore patterns weren't being parsed correctly on Windows

Thanks to @aanand, @dnephin, @mikedougherty, @graingert, @tntC4stl3, @strayobject, @NiR-, @lawliet89, @jtakkala, @ijc25 for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.10.0-rc2 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.10.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.

Here's what's new:

New Features

Compose file version 3.0

• Introduced version 3.0 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.13 or above and is specifically designed to work with the docker stack commands.

Compose file version 2.1 and up

• Healthcheck configuration can now be done in the service definition using the healthcheck parameter
• Containers dependencies can now be set up to wait on positive healthchecks when declared using depends_on. See the documentation for the updated syntax. Note: This feature will not be ported to version 3 Compose files.
• Added support for the sysctls parameter in service definitions
• Added support for the userns_mode parameter in service definitions
• Compose now adds identifying labels to networks and volumes it creates

Compose file version 2.0 and up

• Added support for the stop_grace_period option in service definitions.

Bugfixes

• Colored output now works properly on Windows.
• Fixed a bug where docker-compose run would fail to set up link aliases in interactive mode on Windows.
• Networks created by Compose are now always made attachable (Compose files v2.1 and up).
• Fixed a bug where falsy values of COMPOSE_CONVERT_WINDOWS_PATHS (0, false, empty value) were being interpreted as true.
• Fixed a bug where forward slashes in some .dockerignore patterns weren't being parsed correctly on Windows

Thanks to @aanand, @dnephin, @mikedougherty, @graingert, @tntC4stl3, @strayobject, @NiR-, @lawliet89, @jtakkala, @ijc25 for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.10.0-rc1 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.10.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:

New Features

Compose file version 3.0

• Introduced version 3.0 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.13 or above and is specifically designed to work with the docker stack commands.
  • Added support for the stop_grace_period option in service definitions.

Compose file version 2.1 and up

• Healthcheck configuration can now be done in the service definition using the healthcheck parameter
• Containers dependencies can now be set up to wait on positive healthchecks when declared using depends_on. See the documentation for the updated syntax. Note: This feature will not be ported to version 3 Compose files.
• Added support for the sysctls parameter in service definitions
• Added support for the userns_mode parameter in service definitions
• Compose now adds identifying labels to networks and volumes it creates

Bugfixes

• Colored output now works properly on Windows.
• Fixed a bug where docker-compose run would fail to set up link aliases in interactive mode on Windows.
• Networks created by Compose are now always made attachable (Compose files v2.1 and up).

Thanks to @aanand, @dnephin, @mikedougherty, @strayobject, @NiR-, @lawliet89, @jtakkala, @ijc25, @graingert for contributing to this release!

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.9.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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.9.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.

Here's what's new:

Breaking changes

• When using Compose with Docker Toolbox/Machine on Windows, volume paths are no longer converted from C:\Users to /c/Users-style by default. To re-enable this conversion so that your volumes keep working, set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1. Users of Docker for Windows are not affected and do not need to set the variable.

New Features

• Interactive mode for docker-compose run and docker-compose exec is now supported on Windows platforms. Please note that the docker binary is required to be present on the system for this feature to work.
• Introduced version 2.1 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.12 or above.
  • Added support for setting volume labels and network labels in docker-compose.yml.
  • Added support for the isolation parameter in service definitions.
  • Added support for link-local IPs in the service networks definitions.
  • Added support for shell-style inline defaults in variable interpolation. The supported forms are ${FOO-default} (fall back if FOO is unset) and ${FOO:-default} (fall back if FOO is unset or empty).
• Added support for the group_add and oom_score_adj parameters in service definitions.
• Added support for the internal and enable_ipv6 parameters in network definitions.
• Compose now defaults to using the npipe protocol on Windows.
• Overriding a logging configuration will now properly merge the options mappings if the driver values do not conflict.

Bug Fixes

• Fixed several bugs related to npipe protocol support on Windows.
• Fixed an issue with Windows paths being incorrectly converted when using Docker on Windows Server.
• Fixed a bug where an empty restart value would sometimes result in an exception being raised.
• Fixed an issue where service logs containing unicode characters would sometimes cause an error to occur.
• Fixed a bug where unicode values in environment variables would sometimes raise a unicode exception when retrieved.
• Fixed an issue where Compose would incorrectly detect a configuration mismatch for overlay networks.

Thanks @aanand, @dnephin, @aeriksson, @bfirsh, @londoncalling, @ijc25, @SvenDowideit, @leonhartX, @albers, @Knetic, @johndmulhausen, @jgiannuzzi, @TomasTomecek, @staticshock, @stakodiak, @realityone, @mikedougherty, @jgsqware, @jfroche, @jamesottaway, @dbdd4us, @davidjb, @chrisclark, @allencloud, @adamchainz !

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.9.0-rc4 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.9.0-rc4/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

• When using Compose with Docker Toolbox/Machine on Windows, volume paths are no longer converted from C:\Users to /c/Users-style by default. To re-enable this conversion so that your volumes keep working, set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1. Users of Docker for Windows are not affected and do not need to set the variable.

New Features

• Interactive mode for docker-compose run and docker-compose exec is now supported on Windows platforms. Please note that the docker binary is required to be present on the system for this feature to work.
• Introduced version 2.1 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.12 or above.
  • Added support for setting volume labels and network labels in docker-compose.yml.
  • Added support for the isolation parameter in service definitions.
  • Added support for link-local IPs in the service networks definitions.
  • Added support for shell-style inline defaults in variable interpolation. The supported forms are ${FOO-default} (fall back if FOO is unset) and ${FOO:-default} (fall back if FOO is unset or empty).
• Added support for the group_add and oom_score_adj parameters in service definitions.
• Added support for the internal and enable_ipv6 parameters in network definitions.
• Compose now defaults to using the npipe protocol on Windows.
• Overriding a logging configuration will now properly merge the options mappings if the driver values do not conflict.

Bug Fixes

• Fixed several bugs related to npipe protocol support on Windows.
• Fixed an issue with Windows paths being incorrectly converted when using Docker on Windows Server.
• Fixed a bug where an empty restart value would sometimes result in an exception being raised.
• Fixed an issue where service logs containing unicode characters would sometimes cause an error to occur.
• Fixed a bug where unicode values in environment variables would sometimes raise a unicode exception when retrieved.
• Fixed an issue where Compose would incorrectly detect a configuration mismatch for overlay networks.

Thanks@aanand, @dnephin, @aeriksson, @bfirsh, @londoncalling, @ijc25, @SvenDowideit, @leonhartX, @albers, @Knetic, @johndmulhausen, @jgiannuzzi, @TomasTomecek, @staticshock, @stakodiak, @realityone, @mikedougherty, @jgsqware, @jfroche, @jamesottaway, @dbdd4us, @davidjb, @chrisclark, @allencloud, @adamchainz !

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.9.0-rc3 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.9.0-rc3/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

• When using Compose with Docker Toolbox/Machine on Windows, volume paths are no longer converted from C:\Users to /c/Users-style by default. To re-enable this conversion so that your volumes keep working, set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1. Users of Docker for Windows are not affected and do not need to set the variable.

New Features

• Interactive mode for docker-compose run and docker-compose exec is now supported on Windows platforms. Please note that the docker binary is required to be present on the system for this feature to work.
• Introduced version 2.1 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.12 or above.
  • Added support for setting volume labels and network labels in docker-compose.yml.
  • Added support for the isolation parameter in service definitions.
  • Added support for link-local IPs in the service networks definitions.
  • Added support for shell-style inline defaults in variable interpolation. The supported forms are ${FOO-default} (fall back if FOO is unset) and ${FOO:-default} (fall back if FOO is unset or empty).
• Added support for the group_add and oom_score_adj parameters in service definitions.
• Added support for the internal and enable_ipv6 parameters in network definitions.
• Compose now defaults to using the npipe protocol on Windows.
• Overriding a logging configuration will now properly merge the options mappings if the driver values do not conflict.

Bug Fixes

• Fixed several bugs related to npipe protocol support on Windows.
• Fixed an issue with Windows paths being incorrectly converted when using Docker on Windows Server.
• Fixed a bug where an empty restart value would sometimes result in an exception being raised.
• Fixed an issue where service logs containing unicode characters would sometimes cause an error to occur.
• Fixed a bug where unicode values in environment variables would sometimes raise a unicode exception when retrieved.
• Fixed an issue where Compose would incorrectly detect a configuration mismatch for overlay networks.

Thanks@aanand, @dnephin, @aeriksson, @bfirsh, @londoncalling, @ijc25, @SvenDowideit, @leonhartX, @albers, @Knetic, @johndmulhausen, @jgiannuzzi, @TomasTomecek, @staticshock, @stakodiak, @realityone, @mikedougherty, @jgsqware, @jfroche, @jamesottaway, @dbdd4us, @davidjb, @chrisclark, @allencloud, @adamchainz !

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.9.0-rc2 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.9.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.

Here's what's new:

Breaking changes

• When using Compose with Docker Toolbox/Machine on Windows, volume paths are no longer converted from C:\Users to /c/Users-style by default. To re-enable this conversion so that your volumes keep working, set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1. Users of Docker for Windows are not affected and do not need to set the variable.

New Features

• Interactive mode for docker-compose run and docker-compose exec is now supported on Windows platforms. Please note that the docker binary is required to be present on the system for this feature to work.
• Introduced version 2.1 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.12 or above.
  • Added support for setting volume labels and network labels in docker-compose.yml.
  • Added support for the isolation parameter in service definitions.
  • Added support for link-local IPs in the service networks definitions.
  • Added support for shell-style inline defaults in variable interpolation. The supported forms are ${FOO-default} (fall back if FOO is unset) and ${FOO:-default} (fall back if FOO is unset or empty).
• Added support for the group_add and oom_score_adj parameters in service definitions.
• Added support for the internal and enable_ipv6 parameters in network definitions.
• Compose now defaults to using the npipe protocol on Windows.
• Overriding a logging configuration will now properly merge the options mappings if the driver values do not conflict.

Bug Fixes

• Fixed several bugs related to npipe protocol support on Windows.
• Fixed an issue with Windows paths being incorrectly converted when using Docker on Windows Server.
• Fixed a bug where an empty restart value would sometimes result in an exception being raised.
• Fixed an issue where service logs containing unicode characters would sometimes cause an error to occur.
• Fixed a bug where unicode values in environment variables would sometimes raise a unicode exception when retrieved.

Thanks @aanand, @dnephin, @aeriksson, @bfirsh, @londoncalling, @ijc25, @SvenDowideit, @leonhartX, @albers, @Knetic, @johndmulhausen, @jgiannuzzi, @TomasTomecek, @staticshock, @stakodiak, @realityone, @jgsqware, @jfroche, @jamesottaway, @dbdd4us, @davidjb, @chrisclark, @allencloud, @adamchainz !

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.9.0-rc1 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.9.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

• When using Compose with Docker Toolbox/Machine on Windows, volume paths are no longer converted from C:\Users to /c/Users-style by default. To re-enable this conversion so that your volumes keep working, set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1. Users of Docker for Windows are not affected and do not need to set the variable.

New Features

• Interactive mode for docker-compose run and docker-compose exec is now supported on Windows platforms. Please note that the docker binary is required to be present on the system for this feature to work.
• Introduced version 2.1 of the docker-compose.yml specification. This version requires to be used with Docker Engine 1.12 or above.
  • Added support for setting volume labels and network labels in docker-compose.yml.
  • Added support for the isolation parameter in service definitions.
  • Added support for link-local IPs in the service networks definitions.
  • Added support for shell-style inline defaults in variable interpolation. The supported forms are ${FOO-default} (fall back if FOO is unset) and ${FOO:-default} (fall back if FOO is unset or empty).
• Added support for the group_add and oom_score_adj parameters in service definitions.
• Added support for the internal and enable_ipv6 parameters in network definitions.
• Compose now defaults to using the npipe protocol on Windows.
• Overriding a logging configuration will now properly merge the options mappings if the driver values do not conflict.

Bug Fixes

• Fixed several bugs related to npipe protocol support on Windows.
• Fixed an issue with Windows paths being incorrectly converted when using Docker on Windows Server.
• Fixed a bug where an empty restart value would sometimes result in an exception being raised.
• Fixed an issue where service logs containing unicode characters would sometimes cause an error to occur.
• Fixed a bug where unicode values in environment variables would sometimes raise a unicode exception when retrieved.

Thanks @aanand, @dnephin, @aeriksson, @bfirsh, @londoncalling, @ijc25, @SvenDowideit, @leonhartX, @albers, @Knetic, @johndmulhausen, @jgiannuzzi, @TomasTomecek, @staticshock, @stakodiak, @realityone, @jgsqware, @jfroche, @jamesottaway, @dbdd4us, @davidjb, @chrisclark, @allencloud, @adamchainz !

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.8.1 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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.8.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:

Bug Fixes

• Fixed a bug where users using a credentials store were not able to access their private images.
• Fixed a bug where users using identity tokens to authenticate were not able to access their private images.
• Fixed a bug where an HttpHeaders entry in the docker configuration file would cause Compose to crash when trying to build an image.
• Fixed a few bugs related to the handling of Windows paths in volume binding declarations.
• Fixed a bug where Compose would sometimes crash while trying to read a streaming response from the engine.
• Fixed an issue where Compose would crash when encountering an API error while streaming container logs.
• Fixed an issue where Compose would erroneously try to output logs from drivers not handled by the Engine's API.
• Fixed a bug where options from the docker-machine config command would not be properly interpreted by Compose.
• Fixed a bug where the connection to the Docker Engine would sometimes fail when running a large number of services simultaneously.
• Fixed an issue where Compose would sometimes print a misleading suggestion message when running the bundle command.
• Fixed a bug where connection errors would not be handled properly by Compose during the project initialization phase.
• Fixed a bug where a misleading error would appear when encountering a connection timeout.

Thanks @aanand, @jgsqware

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Note that Compose 1.8.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. Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

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

curl -L https://github.com/docker/compose/releases/download/1.8.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.

Here's what's new:

Breaking Changes

• As announced in 1.7.0, docker-compose rm now removes containers created by docker-compose run by default.
• Setting entrypoint on a service now empties out any default command that was set on the image (i.e. any CMD instruction in the Dockerfile used to build it). This makes it consistent with the --entrypoint flag to docker run.

New Features

• Added docker-compose bundle, a command that builds a bundle file to be consumed by the new Docker Stack commands in Docker 1.12.
• Added docker-compose push, a command that pushes service images to a registry.
• Compose now supports specifying a custom TLS version for interaction with the Docker Engine using the COMPOSE_TLS_VERSION environment variable.

Bug Fixes

• Fixed a bug where Compose would erroneously try to read .env at the project's root when it is a directory.
• docker-compose run -e VAR now passes VAR through from the shell to the container, as with docker run -e VAR.
• Improved config merging when multiple compose files are involved for several service sub-keys.
• Fixed a bug where volume mappings containing Windows drives would sometimes be parsed incorrectly.
• Fixed a bug in Windows environment where volume mappings of the host's root directory would be parsed incorrectly.
• Fixed a bug where docker-compose config would ouput an invalid Compose file if external networks were specified.
• Fixed an issue where unset buildargs would be assigned a string containing 'None' instead of the expected empty value.
• Fixed a bug where yes/no prompts on Windows would not show before receiving input.
• Fixed a bug where trying to docker-compose exec on Windows without the -d option would exit with a stacktrace. This will still fail for the time being, but should do so gracefully.
• Fixed a bug where errors during docker-compose up would show an unrelated stacktrace at the end of the process.
• docker-compose create and docker-compose start show more descriptive error messages when something goes wrong.

Thanks @aanand, @dnephin, @bfirsh, @aeriksson, @SvenDowideit, @londoncalling, @ijc25, @johnharris85, @albers, @leonhartX, @Andrey9kin, @jgiannuzzi, @yorkedork, @werehuman, @twitherspoon, @TomasTomecek, @staticshock, @stakodiak, @spectralsun, @sanmai-NL, @metal3d, @Knetic, @jamesottaway, @denismakogon, @davidjb, @dannyprout, @CRogers, @chrisclark, @aronahl, @anton44eg, @andrerom, @allencloud, @adamchainz, @activatedgeek

Note that Compose 1.8.0 RC2 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.8.0 RC2 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.8.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 changes, RC2 contains the following:

• docker-compose run -e VAR now passes VAR through from the shell to the container, as with docker run -e VAR.
• docker-compose bundle no longer automatically pulls and pushes images if digests are missing, instead printing an error. You can force it to automatically push/pull with --fetch-digests.
• docker-compose bundle now generates a file with the correct extension (.dab).
• Bash and zsh completion have been updated to include the new commands.

Thanks @aeriksson, @shin-, @dnephin, @leonhartX, @bfirsh, @londoncalling, @albers, @staticshock, @stakodiak, @jgiannuzzi, @jamesottaway, @davidjb, @chrisclark, @allencloud, @adamchainz, @SvenDowideit and @Knetic!

Note that Compose 1.8.0-rc1 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.8.0-rc1 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.8.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:

New Features

• Added docker-compose bundle, a command that builds a bundle file to be consumed by the new Docker Stack commands in Docker 1.12. This command automatically pushes and pulls images as needed.
• Added docker-compose push, a command that pushes service images to a registry.
• As announced in 1.7.0, docker-compose rm now removes containers created by docker-compose run by default.
• Compose now supports specifying a custom TLS version for interaction with the Docker Engine using the COMPOSE_TLS_VERSION environment variable.

Bug Fixes

• Fixed a bug where Compose would erroneously try to read .env at the project's root when it is a directory.
• Improved config merging when multiple compose files are involved for several service sub-keys.
• Fixed a bug where volume mappings containing Windows drives would sometimes be parsed incorrectly.
• Fixed a bug in Windows environment where volume mappings of the host's root directory would be parsed incorrectly.
• Fixed a bug where docker-compose config would ouput an invalid Compose file if external networks were specified.
• Fixed an issue where unset buildargs would be assigned a string containing 'None' instead of the expected empty value.
• Fixed a bug where yes/no prompts on Windows would not show before receiving input.
• Fixed a bug where trying to docker-compose exec on Windows without the -d option would exit with a stacktrace. This will still fail for the time being, but should do so gracefully.
• Fixed a bug where errors during docker-compose up would show an unrelated stacktrace at the end of the process.

Thanks @aanand, @dnephin, @bfirsh, @SvenDowideit, @sdurrheimer, @londoncalling, @johnharris85, @Andrey9kin, @yorkedork, @werehuman, @wenchma, @twitherspoon, @spectralsun, @sanmai-NL, @metal3d, @KalleDK, @jonlemmon, @denismakogon, @dannyprout, @CRogers, @aronahl, @anton44eg, @andrerom, @albers, @activatedgeek

Note that Compose 1.7.1 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.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.7.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:

Bug Fixes

• Fixed a bug where the output of docker-compose config for v1 files would be an invalid configuration file.
• Fixed a bug where docker-compose config would not check the validity of links.
• Fixed an issue where docker-compose help would not output a list of available commands and generic options as expected.
• Fixed an issue where filtering by service when using docker-compose logs would not apply for newly created services.
• Fixed a bug where unchanged services would sometimes be recreated in in the up phase when using Compose with Python 3.
• Fixed an issue where API errors encountered during the up phase would not be recognized as a failure state by Compose.
• Fixed a bug where Compose would raise a NameError because of an undefined exception name on non-Windows platforms.
• Fixed a bug where the wrong version of docker-py would sometimes be installed alongside Compose.
• Fixed a bug where the host value output by docker-machine config default would not be recognized as valid options by the docker-compose command line.
• Fixed an issue where Compose would sometimes exit unexpectedly while reading events broadcasted by a Swarm cluster.
• Corrected a statement in the docs about the location of the .env file, which is indeed read from the current directory, instead of in the same location as the Compose file.

Thanks @aanand, @shin-, @dnephin, @bfirsh, @johnharris85, @werehuman, @twitherspoon, @metal3d, @aronahl, @andrerom

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/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

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-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.

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

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

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.

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

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!

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

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

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

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!

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

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.0rc2/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.0rc2 if you prefer pip.

Here's what's new:

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