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="" Format output using a custom template: 'table': Print output in table format with column headers (default) 'table TEMPLATE': Print output in table format using the given Go template 'json': Print in JSON format 'TEMPLATE': Print output using the given Go template. Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates
-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 container IDs
-s, --size[=false] Display total file sizes