DockerCLI/docs/reference/commandline/container_wait.md

46 lines
820 B
Markdown

# wait
<!---MARKER_GEN_START-->
Block until one or more containers stop, then print their exit codes
### Aliases
`docker container wait`, `docker wait`
<!---MARKER_GEN_END-->
> [!NOTE]
> `docker wait` returns `0` when run against a container which had already
> exited before the `docker wait` command was run.
## Examples
Start a container in the background.
```console
$ docker run -dit --name=my_container ubuntu bash
```
Run `docker wait`, which should block until the container exits.
```console
$ docker wait my_container
```
In another terminal, stop the first container. The `docker wait` command above
returns the exit code.
```console
$ docker stop my_container
```
This is the same `docker wait` command from above, but it now exits, returning
`0`.
```console
$ docker wait my_container
0
```