docker-compose up
Usage: docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...] Options: -d, --detach Detached mode: Run containers in the background, print new container names. Incompatible with --abort-on-container-exit. --no-color Produce monochrome output. --quiet-pull Pull without printing progress information --no-deps Don't start linked services. --force-recreate Recreate containers even if their configuration and image haven't changed. --always-recreate-deps Recreate dependent containers. Incompatible with --no-recreate. --no-recreate If containers already exist, don't recreate them. Incompatible with --force-recreate and --renew-anon-volumes. --no-build Don't build an image, even if it's missing. --no-start Don't start the services after creating them. --build Build images before starting containers. --abort-on-container-exit Stops all containers if any container was stopped. Incompatible with --detach. --attach-dependencies Attach to dependent containers. -t, --timeout TIMEOUT Use this timeout in seconds for container shutdown when attached or when containers are already running. (default: 10) -V, --renew-anon-volumes Recreate anonymous volumes instead of retrieving data from the previous containers. --remove-orphans Remove containers for services not defined in the Compose file. --exit-code-from SERVICE Return the exit code of the selected service container. Implies --abort-on-container-exit. --scale SERVICE=NUM Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present.
Builds, (re)creates, starts, and attaches to containers for a service.
Unless they are already running, this command also starts any linked services.
The docker-compose up
command aggregates the output of each container (essentially running docker-compose logs --follow
). When the command exits, all containers are stopped. Running docker-compose up --detach
starts the containers in the background and leaves them running.
If there are existing containers for a service, and the service’s configuration or image was changed after the container’s creation, docker-compose up
picks up the changes by stopping and recreating the containers (preserving mounted volumes). To prevent Compose from picking up changes, use the --no-recreate
flag.
If you want to force Compose to stop and recreate all containers, use the --force-recreate
flag.
If the process encounters an error, the exit code for this command is 1
.
If the process is interrupted using SIGINT
(ctrl
+ C
) or SIGTERM
, the containers are stopped, and the exit code is 0
.
If SIGINT
or SIGTERM
is sent again during this shutdown phase, the running containers are killed, and the exit code is 2
.
fig, composition, compose, docker, orchestration, cli, up
© 2019 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/compose/reference/up/