Skip to end of metadata
Go to start of metadata

This feature is currently in development and may change in future.

Starting from TeamCity 2017.2 EAP1, TeamCity comes with built-in Docker support, which includes the Docker Compose runner.




The integration requires Docker installed on the build agents. Docker Compose also needs to be installed to use the Docker Compose build runner.

The runner allows starting docker-compose build services, and shutting down those services at the end of the build.

docker-compose YAML file with a description of the services to be used during the build is required. The path to the docker-compose.yml file should be relative to the checkout directory

The executed commands are


When using docker-compose with images which support HEALTHCHECK, TeamCity will wait for the healthy status of all containers, which support this parameter.

If the start of Docker Compose was successful, TeamCity agent will register the TEAMCITY_DOCKER_NETWORK environment variable  containing the name of the docker-compose default network. This network will be passed transparently to the Docker Wrapper when used in some build runners. 


  • No labels


  1. Are there any plans to support the docker-compose build command?

    1. Hello,

      So far it looks quite simple to use Command-line runner for that. I.e. you can run docker-compose build command from this runner.

      If you think TeamCity can help you somehow further, please add a corresponding issue with description to our tracker: