docker-ps - Man Page
List containers
Examples (TL;DR)
- List currently running docker containers:
docker ps
- List all docker containers (running and stopped):
docker ps --all
- Show the latest created container (includes all states):
docker ps --latest
- Filter containers that contain a substring in their name:
docker ps --filter="name=name"
- Filter containers that share a given image as an ancestor:
docker ps --filter "ancestor=image:tag"
- Filter containers by exit status code:
docker ps --all --filter="exited=code"
- Filter containers by status (created, running, removing, paused, exited and dead):
docker ps --filter="status=status"
- Filter containers that mount a specific volume or have a volume mounted in a specific path:
docker ps --filter="volume=path/to/directory" --format "table .ID\t.Image\t.Names\t.Mounts"
Synopsis
docker ps [Options]
Description
Alias for docker container ls
.
Options
- -a, --all[=false]
Show all containers (default shows just running)
- -f, --filter=
Filter output based on conditions provided
- --format=""
Pretty-print containers using a Go template
- -h, --help[=false]
help for ps
- -n, --last=-1
Show n last created containers (includes all states)
- -l, --latest[=false]
Show the latest created container (includes all states)
- --no-trunc[=false]
Don't truncate output
- -q, --quiet[=false]
Only display numeric IDs
- -s, --size[=false]
Display total file sizes
See Also
Referenced By
May 2020 Docker Community