2016-10-14 22:30:36 +00:00
|
|
|
---
|
|
|
|
title: "wait"
|
|
|
|
description: "The wait command description and usage"
|
2016-11-03 22:48:30 +00:00
|
|
|
keywords: "container, stop, wait"
|
2016-10-14 22:30:36 +00:00
|
|
|
---
|
2015-06-21 20:41:38 +00:00
|
|
|
|
2016-10-19 17:25:45 +00:00
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
|
|
repository at https://github.com/docker/docker/. Make all
|
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
will be rejected.
|
|
|
|
-->
|
|
|
|
|
2015-06-21 20:41:38 +00:00
|
|
|
# wait
|
|
|
|
|
2016-07-07 18:43:18 +00:00
|
|
|
```markdown
|
|
|
|
Usage: docker wait CONTAINER [CONTAINER...]
|
2015-06-21 20:41:38 +00:00
|
|
|
|
2016-08-30 15:07:42 +00:00
|
|
|
Block until one or more containers stop, then print their exit codes
|
2015-10-03 15:56:41 +00:00
|
|
|
|
2016-07-07 18:43:18 +00:00
|
|
|
Options:
|
2017-03-31 03:01:41 +00:00
|
|
|
--help Print usage
|
2016-07-07 18:43:18 +00:00
|
|
|
```
|
2017-02-07 23:42:48 +00:00
|
|
|
|
|
|
|
> **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.
|
|
|
|
|
|
|
|
```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
|
|
|
|
```
|