LinuxCommandLibrary

docker-ps

List Docker containers.

TLDR

List currently running docker containers

$ docker ps
copy


List all docker containers (running and stopped)
$ docker ps --all
copy


Show the latest created container (includes all states)
$ docker ps --latest
copy


Filter containers that contain a substring in their name
$ docker ps --filter="name=[name]"
copy


Filter containers that share a given image as an ancestor
$ docker ps --filter "ancestor=[image]:[tag]"
copy


Filter containers by exit status code
$ docker ps --all --filter="exited=[code]"
copy


Filter containers by status (created, running, removing, paused, exited and dead)
$ docker ps --filter="status=[status]"
copy


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]"
copy

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:

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

SEE ALSO

docker(1)

Copied to clipboard