2021-03-08 15:47:24 +01:00
command : docker compose up
short : Create and start containers
2021-09-13 17:38:29 +02:00
long : "Builds, (re)creates, starts, and attaches to containers for a service.\n\nUnless they are already running, this command also starts any linked services.\n\nThe `docker compose up` command aggregates the output of each container (liked `docker compose logs --follow` does). \nWhen the command exits, all containers are stopped. Running `docker compose up --detach` starts the containers in the \nbackground and leaves them running.\n\nIf there are existing containers for a service, and the service’ s configuration or image was changed after the \ncontainer’ s creation, `docker compose up` picks up the changes by stopping and recreating the containers \n(preserving mounted volumes). To prevent Compose from picking up changes, use the `--no-recreate` flag.\n\nIf you want to force Compose to stop and recreate all containers, use the `--force-recreate` flag.\n\nIf the process encounters an error, the exit code for this command is `1`.\nIf the process is interrupted using `SIGINT` (ctrl + C) or `SIGTERM`, the containers are stopped, and the exit code is `0`."
2021-03-08 15:47:24 +01:00
usage : docker compose up [SERVICE...]
pname : docker compose
plink : docker_compose.yaml
options :
2021-09-13 17:38:29 +02:00
- option : abort-on-container-exit
value_type : bool
default_value : "false"
description : |
2021-03-08 15:47:24 +01:00
Stops all containers if any container was stopped. Incompatible with -d
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : always-recreate-deps
value_type : bool
default_value : "false"
description : |
2021-03-08 15:47:24 +01:00
Recreate dependent containers. Incompatible with --no-recreate.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : attach
value_type : stringArray
default_value : '[]'
description : Attach to service output.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : attach-dependencies
value_type : bool
default_value : "false"
description : Attach to dependent containers.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : build
value_type : bool
default_value : "false"
description : Build images before starting containers.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : detach
shorthand : d
value_type : bool
default_value : "false"
description: 'Detached mode : Run containers in the background'
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : environment
shorthand : e
value_type : stringArray
default_value : '[]'
description : Environment variables
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : exit-code-from
value_type : string
description : |
2021-03-08 15:47:24 +01:00
Return the exit code of the selected service container. Implies --abort-on-container-exit
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : force-recreate
value_type : bool
default_value : "false"
description : |
2021-03-08 15:47:24 +01:00
Recreate containers even if their configuration and image haven't changed.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : no -build
value_type : bool
default_value : "false"
description : Don't build an image, even if it's missing.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : no -color
value_type : bool
default_value : "false"
description : Produce monochrome output.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : no -deps
value_type : bool
default_value : "false"
description : Don't start linked services.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : no -log-prefix
value_type : bool
default_value : "false"
description : Don't print prefix in logs.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : no -recreate
value_type : bool
default_value : "false"
description : |
2021-03-08 15:47:24 +01:00
If containers already exist, don't recreate them. Incompatible with --force-recreate.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : no -start
value_type : bool
default_value : "false"
description : Don't start the services after creating them.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : quiet-pull
value_type : bool
default_value : "false"
description : Pull without printing progress information.
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : remove-orphans
value_type : bool
default_value : "false"
description : |
2021-03-08 15:47:24 +01:00
Remove containers for services not defined in the Compose file.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : renew-anon-volumes
shorthand : V
value_type : bool
default_value : "false"
description : |
2021-03-08 15:47:24 +01:00
Recreate anonymous volumes instead of retrieving data from the previous containers.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : scale
value_type : stringArray
default_value : '[]'
description : |
2021-03-08 15:47:24 +01:00
Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
- option : timeout
shorthand : t
value_type : int
default_value : "10"
description : |
2021-03-08 15:47:24 +01:00
Use this timeout in seconds for container shutdown when attached or when containers are already running.
2021-09-13 17:38:29 +02:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false
2021-03-08 15:47:24 +01:00
deprecated : false
experimental : false
experimentalcli : false
kubernetes : false
swarm : false