2.37. Docker ps command

2.37.1. Grammar ¶

docker ps [OPTIONS] 

OPTIONS description:

• -a : Displays all containers, including those that are not running.

• -f : Filter the displayed content based on the criteria.

• –format : Specifies the template file for the return value.

• -l : Displays the most recently created container.

• -n : List the most recently created n containers.

• –no-trunc : The output is not truncated.

• -q : Silent mode, showing only the container number.

• -s : Displays the total file size.

2.37.2. Example ¶

Lists all running container information.

runoob@runoob:~$ docker ps CONTAINER ID IMAGE COMMAND ... PORTS NAMES 09b93464c2f7 nginx:latest "nginx -g 'daemon off" ... 80/tcp, 443/tcp myrunoob 96f7f14e99ab mysql:5.6 "docker-entrypoint.sh" ... 0.0.0.0:3306->3306/tcp mymysql 

Description of output details:

CONTAINER ID: Container ID.

IMAGE: The mirror image used.

COMMAND: The command that runs when the container is started.

CREATED: The time when the container was created.

STATUS: Container status.

There are 7 states:

• Created (created)

• Restarting (restarting)

• Running (running)

• Removing (migrating)

• Paused (pause)

• Exited (stop)

• Dead (death)

PORTS: The port information of the container and the connection type used (tcpudp).

NAMES: The container name that is automatically assigned.

Lists the information of the 5 recently created containers.

runoob@runoob:~$ docker ps -n 5 CONTAINER ID IMAGE COMMAND CREATED 09b93464c2f7 nginx:latest "nginx -g 'daemon off" 2 days ago ... b8573233d675 nginx:latest "/bin/bash" 2 days ago ... b1a0703e41e7 nginx:latest "nginx -g 'daemon off" 2 days ago ... f46fb1dec520 5c6e1090e771 "/bin/sh -c 'set -x \t" 2 days ago ... a63b4a5597de 860c279d2fec "bash" 2 days ago ... 

Lists all created container ID.

runoob@runoob:~$ docker ps -a -q 09b93464c2f7 b8573233d675 b1a0703e41e7 f46fb1dec520 a63b4a5597de 6a4aa42e947b de7bb36e7968 43a432b73776 664a8ab1a585 ba52eb632bbd ... 

Docker 命令大全