Compose V1 no longer receives updates and will not be available in new releases of Docker Desktop after June 2023.
Compose V2 is included with all currently supported versions of Docker Desktop. For more information, see Migrate to Compose V2.
The Compose file is a YAML file defining services, networks, and volumes for a Docker application. The latest and recommended version of the Compose file format is defined by the Compose Specification. The Compose spec merges the legacy 2.x and 3.x versions, aggregating properties across these formats and is implemented by Compose 1.27.0+.
Use the links below to easily navigate key sections of the Compose specification.
Status of the Specification
Read about the status of the specification.
The Compose application model
Learn about the Compose application model.
The Compose file
Understand the Compose file.
Version and name top-level element
Understand version and name attributes for Compose.
Services top-level element
Explore all services attributes for Compose.
Networks top-level element
Find all networks attributes for Compose.
Volumes top-level element
Explore all volumes attributes for Compose.
Configs top-level element
Find out about configs in Compose.
Secrets top-level element
Learn about secrets in Compose.