| # 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 |
| ``` |
