NAME

       docker-ps - List containers

SYNOPSIS

       docker   ps  [-a|--all[=false]]  [--before[=BEFORE]]  [--help]  [-f|--filter[=[]]]  [-l|--latest[=false]]
       [-n[=-1]] [--no-trunc[=false]] [-q|--quiet[=false]] [-s|--size[=false]] [--since[=SINCE]]

DESCRIPTION

       List the containers in the local repository. By default this show only the running containers.

OPTIONS

       -a, --all=true|false
          Show all containers. Only running containers are shown by default. The default is false.

       --before=""
          Show only container created before Id or Name, include non-running ones.

       --help
         Print usage statement

       -f, --filter=[]
          Provide filter values. Valid filters:
                                 exited= - containers with exit code of
                                 label= or label==
                                 status=(restarting|running|paused|exited)
                                 name= - container's name
                                 id= - container's ID

       -l, --latest=true|false
          Show only the latest created container, include non-running ones. The default is false.

       -n=-1
          Show n last created containers, include non-running ones.

       --no-trunc=true|false
          Don't truncate output. The default is false.

       -q, --quiet=true|false
          Only display numeric IDs. The default is false.

       -s, --size=true|false
          Display total file sizes. The default is false.

       --since=""
          Show only containers created since Id or Name, include non-running ones.

EXAMPLES

Display all containers, including non-running

              # docker ps -a
              CONTAINER ID        IMAGE                 COMMAND                CREATED             STATUS      PORTS    NAMES
              a87ecb4f327c        fedora:20             /bin/sh -c #(nop) MA   20 minutes ago      Exit 0               desperate_brattain
              01946d9d34d8        vpavlin/rhel7:latest  /bin/sh -c #(nop) MA   33 minutes ago      Exit 0               thirsty_bell
              c1d3b0166030        acffc0358b9e          /bin/sh -c yum -y up   2 weeks ago         Exit 1               determined_torvalds
              41d50ecd2f57        fedora:20             /bin/sh -c #(nop) MA   2 weeks ago         Exit 0               drunk_pike

Display only IDs of all containers, including non-running

              # docker ps -a -q
              a87ecb4f327c
              01946d9d34d8
              c1d3b0166030
              41d50ecd2f57

Display only IDs of all containers that have the name determined_torvalds

              # docker ps -a -q --filter=name=determined_torvalds
              c1d3b0166030

HISTORY

       April 2014, Originally compiled by William Henry (whenry at redhat dot com) based  on  docker.com  source
       material  and internal work.  June 2014, updated by Sven Dowideit ⟨SvenDowideit@home.org.au⟩ August 2014,
       updated  by  Sven  Dowideit  ⟨SvenDowideit@home.org.au⟩  November  2014,   updated   by   Sven   Dowideit
       ⟨SvenDowideit@home.org.au⟩ February 2015, updated by André Martins ⟨martins@noironetworks.com⟩

Docker Community                               Docker User Manuals                                     DOCKER(1)