2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "wait"
|
|
|
|
description: "The wait command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "container, stop, wait"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
|
|
# wait
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
|
|
|
Usage: docker wait CONTAINER [CONTAINER...]
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2016-08-30 11:07:42 -04:00
|
|
|
Block until one or more containers stop, then print their exit codes
|
2015-10-03 11:56:41 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Options:
|
2017-03-30 23:01:41 -04:00
|
|
|
--help Print usage
|
2016-07-07 14:43:18 -04:00
|
|
|
```
|
2017-02-07 18:42:48 -05:00
|
|
|
|
2020-04-19 09:43:08 -04:00
|
|
|
> **Note**
|
|
|
|
>
|
|
|
|
> `docker wait` returns `0` when run against a container which had already
|
|
|
|
> exited before the `docker wait` command was run.
|
2017-02-07 18:42:48 -05:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
Start a container in the background.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker run -dit --name=my_container ubuntu bash
|
|
|
|
```
|
|
|
|
|
|
|
|
Run `docker wait`, which should block until the container exits.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker wait my_container
|
|
|
|
```
|
|
|
|
|
|
|
|
In another terminal, stop the first container. The `docker wait` command above
|
|
|
|
returns the exit code.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker stop my_container
|
|
|
|
```
|
|
|
|
|
|
|
|
This is the same `docker wait` command from above, but it now exits, returning
|
|
|
|
`0`.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker wait my_container
|
|
|
|
|
|
|
|
0
|
|
|
|
```
|