DockerCLI/docs/reference/commandline/wait.md

55 lines
982 B
Markdown

---
title: "wait"
description: "The wait command description and usage"
keywords: "container, stop, wait"
---
# wait
```markdown
Usage: docker wait CONTAINER [CONTAINER...]
Block until one or more containers stop, then print their exit codes
Aliases:
docker container wait, docker wait
Options:
--help Print usage
```
> **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
```