docker compose up

Create and start containers


$ docker compose up [OPTIONS] [SERVICE...]

Refer to the options section for an overview of available OPTIONS for this command.


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.


Name, shorthand Default Description
--abort-on-container-exit Stops all containers if any container was stopped. Incompatible with -d
--always-recreate-deps Recreate dependent containers. Incompatible with --no-recreate.
--attach Attach to service output.
--attach-dependencies Attach to dependent containers.
--build Build images before starting containers.
--detach , -d Detached mode: Run containers in the background
--exit-code-from Return the exit code of the selected service container. Implies --abort-on-container-exit
--force-recreate Recreate containers even if their configuration and image haven’t changed.
--no-attach Don’t attach to specified service.
--no-build Don’t build an image, even if it’s missing.
--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.
--no-start Don’t start the services after creating them.
--pull missing Pull image before running (“always”|”missing”|”never”)
--quiet-pull Pull without printing progress information.
--remove-orphans Remove containers for services not defined in the Compose file.
--renew-anon-volumes , -V Recreate anonymous volumes instead of retrieving data from the previous containers.
--scale Scale SERVICE to NUM instances. Overrides the scale setting in the Compose file if present.
--timeout , -t 10 Use this timeout in seconds for container shutdown when attached or when containers are already running.
--timestamps Show timestamps.
--wait Wait for services to be running|healthy. Implies detached mode.
--wait-timeout timeout waiting for application to be running|healthy.
--dry-run Execute command in dry run mode

Parent command

Command Description
docker compose Docker Compose
Command Description
docker compose build Build or rebuild services
docker compose config Parse, resolve and render compose file in canonical format
docker compose cp Copy files/folders between a service container and the local filesystem
docker compose create Creates containers for a service.
docker compose down Stop and remove containers, networks
docker compose events Receive real time events from containers.
docker compose exec Execute a command in a running container.
docker compose images List images used by the created containers
docker compose kill Force stop service containers.
docker compose logs View output from containers
docker compose ls List running compose projects
docker compose pause Pause services
docker compose port Print the public port for a port binding.
docker compose ps List containers
docker compose pull Pull service images
docker compose push Push service images
docker compose restart Restart service containers
docker compose rm Removes stopped service containers
docker compose run Run a one-off command on a service.
docker compose start Start services
docker compose stop Stop services
docker compose top Display the running processes
docker compose unpause Unpause services
docker compose up Create and start containers
docker compose version Show the Docker Compose version information