# docker compose up

**Description:** Create and start containers

**Usage:** `docker compose up [OPTIONS] [SERVICE...]`










## Description

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 (like `docker compose logs --follow` does).
One can optionally select a subset of services to attach to using `--attach` flag, or exclude some services using
`--no-attach` to prevent output to be flooded by some verbose services.

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`.


## Options

| Option | Default | Description |
|--------|---------|-------------|
| `--abort-on-container-exit` |  |  Stops all containers if any container was stopped. Incompatible with -d<br> |
| `--abort-on-container-failure` |  |  Stops all containers if any container exited with failure. Incompatible with -d<br> |
| `--always-recreate-deps` |  |  Recreate dependent containers. Incompatible with --no-recreate. |
| `--attach` |  |  Restrict attaching to the specified services. Incompatible with --attach-dependencies.<br> |
| `--attach-dependencies` |  |  Automatically attach to log output of dependent services |
| `--build` |  |  Build images before starting containers |
| `-d`, `--detach` |  |  Detached mode: Run containers in the background |
| `--exit-code-from` |  |  Return the exit code of the selected service container. Implies --abort-on-container-exit<br> |
| `--force-recreate` |  |  Recreate containers even if their configuration and image haven't changed<br> |
| `--menu` |  |  Enable interactive shortcuts when running attached. Incompatible with --detach. Can also be enable/disable by setting COMPOSE_MENU environment var.<br> |
| `--no-attach` |  |  Do not attach (stream logs) to the specified services |
| `--no-build` |  |  Don't build an image, even if it's policy |
| `--no-color` |  |  Produce monochrome output |
| `--no-deps` |  |  Don't start linked services |
| `--no-log-prefix` |  |  Don't print prefix in logs |
| `--no-recreate` |  |  If containers already exist, don't recreate them. Incompatible with --force-recreate.<br> |
| `--no-start` |  |  Don't start the services after creating them |
| `--pull` | `policy` |  Pull image before running ("always"|"missing"|"never") |
| `--quiet-build` |  |  Suppress the build output |
| `--quiet-pull` |  |  Pull without printing progress information |
| `--remove-orphans` |  |  Remove containers for services not defined in the Compose file |
| `-V`, `--renew-anon-volumes` |  |  Recreate anonymous volumes instead of retrieving data from the previous containers<br> |
| `--scale` |  |  Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present.<br> |
| `-t`, `--timeout` |  |  Use this timeout in seconds for container shutdown when attached or when containers are already running<br> |
| `--timestamps` |  |  Show timestamps |
| `--wait` |  |  Wait for services to be running|healthy. Implies detached mode. |
| `--wait-timeout` |  |  Maximum duration in seconds to wait for the project to be running|healthy<br> |
| `-w`, `--watch` |  |  Watch source code and rebuild/refresh containers when files are updated.<br> |
| `-y`, `--yes` |  |  Assume "yes" as answer to all prompts and run non-interactively |