docker wait

Estimated reading time: 1 minute

Edge only: This is the CLI reference for Docker CE Edge versions. Some of these options may not be available to Docker CE stable or Docker EE. You can view the stable version of this CLI reference or learn about Docker CE Edge.

Description

Block until one or more containers stop, then print their exit codes

Usage

docker wait CONTAINER [CONTAINER...]

Parent command

Command Description
docker The base command for the Docker CLI.

Examples

Start a container in the background.

$ docker run -dit --name=my_container ubuntu bash

Run docker wait, which should block until the container exits.

$ docker wait my_container

In another terminal, stop the first container. The docker wait command above returns the exit code.

$ docker stop my_container

This is the same docker wait command from above, but it now exits, returning 0.

$ docker wait my_container

0