diff --git a/pages/common/docker-ps.md b/pages/common/docker-ps.md new file mode 100644 index 000000000..9e629e1f9 --- /dev/null +++ b/pages/common/docker-ps.md @@ -0,0 +1,36 @@ +# docker ps + +> List Docker containers. +> More information: . + +- 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}}"`