Docker Compose Modularity with `include`

With include support in the latest Compose 2.20 version, Docker Compose makes it easier to modularize complex applications into sub-compose files. This capability allows application configuration to be simpler and more explicit. It also helps to reflect the engineering team responsible for the code in the config file organization. With each team able to reflect in configuration the way it depends on other’s work, there’s a natural approach to compose.yaml files organization.






- database

Learn More: Docker Compose Modularity with `include` | Docker

Here’s a simple example:

Demonstrating the power of Compose Include


  • Install Docker Compose v2.20.x
  mv docker-compose-linux-x86_64 docker-compose
  chmod +x docker-compose
  docker-compose version
  Docker Compose version v2.20.2

Getting Started

Clone the repository

 git clone
 cd compose-include

Run the Services

 docker-compose -f web.yaml up
docker-compose -f web.yaml ps 
NAME                IMAGE               COMMAND                  SERVICE             CREATED             STATUS              PORTS
root-database-1     postgres:12         "docker-entrypoint.s…"   database            10 minutes ago      Up 2 minutes        5432/tcp
root-web-1          nginx:latest        "/docker-entrypoint.…"   web                 10 minutes ago