mirror of https://github.com/docker/docs.git
62 lines
3.3 KiB
Markdown
62 lines
3.3 KiB
Markdown
---
|
|
description: Builds, (re)creates, starts, and attaches to containers for a service.
|
|
keywords: fig, composition, compose, docker, orchestration, cli, up
|
|
title: docker-compose up
|
|
notoc: true
|
|
---
|
|
|
|
```
|
|
Usage: 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 -V.
|
|
--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 -d.
|
|
-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 -f`). When
|
|
the command exits, all containers are stopped. Running `docker-compose up -d`
|
|
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`.
|