Key Features and Capabilities
- If not provided, Compose looks for a file named docker-compose.yml in the current directory and then each parent directory in succession until a file by that name is found. This variable supports multiple Compose files separated by a path separator (on Linux and macOS the path separator is:, on Windows it is; ).
- Apt get -even after adding the repositories they specify for docker CE, seems to only contain docker-compose 1.8, which is compatible with a maximum docker-compose.yml file of version 2.
The fastest way to design and deliver containerized applications and microservices on the desktop and cloud.
Simple Setup for Docker and Kubernetes
No need to fiddle with VMs or add a bunch of extra components; simply install from a single package and have your first containers running in minutes. You get certified Kubernetes and Docker, for developers of all levels of container expertise.
Windows prompts you for access every time Docker starts, allowing Docker to manage the Hyper-V VM’s. The first time Docker starts, you may need to provide the token from the Beta invitation email. When initialization completes, select About Docker from the notification area and verify you have the latest version. Learn more about docker volumes. WordPress Multisite works only on ports 80 and 443. Build the project. Now, run docker-compose up -d from your project directory. This runs docker-compose up in detached mode, pulls the needed Docker images, and starts the wordpress and database containers, as shown in the example below.
Certified Kubernetes
Setup a fully functional Kubernetes environment on your desktop with a single click and start developing and testing modern applications in minutes.
Application Templates and App Designer
Customize and share multi-service applications and service templates that are tailored to your organization. Pre-defined and customizable application templates adhere to corporate standards and automate configuration, eliminating error-prone manual setup. Intuitive Application Designer facilitates the packaging, installing, and managing of multi-service applications as a shareable package.
Estimated reading time: 4 minutes
Several environment variables are available for you to configure the Docker Compose command-line behaviour.
Variables starting with DOCKER_
are the same as those used to configure theDocker command-line client. If you’re using docker-machine
, then the eval '$(docker-machine env my-docker-vm)'
command should set them to their correct values. (In this example, my-docker-vm
is the name of a machine you created.)
Note: Some of these variables can also be provided using anenvironment file.
COMPOSE_PROJECT_NAME
Sets the project name. This value is prepended along with the service name tothe container on start up. For example, if your project name is myapp
and itincludes two services db
and web
, then Compose starts containers namedmyapp_db_1
and myapp_web_1
respectively.
Docker Compose For Windows
Setting this is optional. If you do not set this, the COMPOSE_PROJECT_NAME
defaults to the basename
of the project directory. See also the -p
command-line option.
COMPOSE_FILE
Specify the path to a Compose file. If not provided, Compose looks for a file nameddocker-compose.yml
in the current directory and then each parent directory insuccession until a file by that name is found.
This variable supports multiple Compose files separated by a path separator (onLinux and macOS the path separator is :
, on Windows it is ;
). For example:COMPOSE_FILE=docker-compose.yml:docker-compose.prod.yml
. The path separatorcan also be customized using COMPOSE_PATH_SEPARATOR
.
See also the -f
command-line option.
COMPOSE_PROFILES
Specify one or multiple active profiles to enable. Calling docker-compose up
with COMPOSE_PROFILES=frontend
will start the services with the profilefrontend
and services without specified profiles.
You can specify a list of profiles separated with a comma:COMPOSE_PROFILES=frontend,debug
will enable the profiles frontend
anddebug
.
See also Using profiles with Compose and the --profile
command-line option.
COMPOSE_API_VERSION
The Docker API only supports requests from clients which report a specificversion. If you receive a client and server don't have same version
error usingdocker-compose
, you can workaround this error by setting this environmentvariable. Set the version value to match the server version.
Setting this variable is intended as a workaround for situations where you needto run temporarily with a mismatch between the client and server version. Forexample, if you can upgrade the client but need to wait to upgrade the server.
Running with this variable set and a known mismatch does prevent some Dockerfeatures from working properly. The exact features that fail would depend on theDocker client and server versions. For this reason, running with this variableset is only intended as a workaround and it is not officially supported.
If you run into problems running with this set, resolve the mismatch throughupgrade and remove this setting to see if your problems resolve before notifyingsupport.
DOCKER_HOST
Sets the URL of the docker
daemon. As with the Docker client, defaults to unix:///var/run/docker.sock
.
DOCKER_TLS_VERIFY
When set to anything other than an empty string, enables TLS communication withthe docker
daemon.
DOCKER_CERT_PATH
Configures the path to the ca.pem
, cert.pem
, and key.pem
files used for TLS verification. Defaults to ~/.docker
.
COMPOSE_HTTP_TIMEOUT
Configures the time (in seconds) a request to the Docker daemon is allowed to hang before Compose considersit failed. Defaults to 60 seconds.
COMPOSE_TLS_VERSION
Configure which TLS version is used for TLS communication with the docker
daemon. Defaults to TLSv1
.Supported values are: TLSv1
, TLSv1_1
, TLSv1_2
.
COMPOSE_CONVERT_WINDOWS_PATHS
Enable path conversion from Windows-style to Unix-style in volume definitions.Users of Docker Machine on Windows should always set this. Defaults to 0
.Supported values: true
or 1
to enable, false
or 0
to disable.
Docker Compose Windows Volume
COMPOSE_PATH_SEPARATOR
If set, the value of the COMPOSE_FILE
environment variable is separatedusing this character as path separator.
COMPOSE_FORCE_WINDOWS_HOST
If set, volume declarations using the short syntaxare parsed assuming the host path is a Windows path, even if Compose isrunning on a UNIX-based system.Supported values: true
or 1
to enable, false
or 0
to disable.
COMPOSE_IGNORE_ORPHANS
If set, Compose doesn’t try to detect orphaned containers for the project.Supported values: true
or 1
to enable, false
or 0
to disable.
COMPOSE_PARALLEL_LIMIT
Sets a limit for the number of operations Compose can execute in parallel. Thedefault value is 64
, and may not be set lower than 2
.
COMPOSE_INTERACTIVE_NO_CLI
Docker Compose Windows
If set, Compose doesn’t attempt to use the Docker CLI for interactive run
and exec
operations. This option is not available on Windows where the CLIis required for the aforementioned operations.Supported: true
or 1
to enable, false
or 0
to disable.
COMPOSE_DOCKER_CLI_BUILD
Configure whether to use the Compose python client for building images or thenative docker cli. By default, Compose uses the docker
CLI to perform builds,which allows you to use BuildKitto perform builds.
Set COMPOSE_DOCKER_CLI_BUILD=0
to disable native builds, and to use the built-inpython client.