246

Docker gives you a way of listing running containers or all containers including stopped ones.

This can be done by:

$ docker ps # To list running containers

Or by

$ docker ps -a # To list running and stopped containers

Do we have a way of only listing containers that have been stopped?

Peter Mortensen
  • 30,030
  • 21
  • 100
  • 124
Yogesh_D
  • 15,585
  • 9
  • 35
  • 50

3 Answers3

362

Only stopped containers can be listed using:

docker ps --filter "status=exited"

or

docker ps -f "status=exited"
Yogesh_D
  • 15,585
  • 9
  • 35
  • 50
  • 4
    Also, you can filter them with `grep` for example `docker ps -a | grep Exited` or something like that. – starikovs May 14 '15 at 08:08
  • 26
    Cool, now I can remove stopped containers with `docker rm $(docker ps --filter "status=exited" -q)` – czerasz Jan 19 '16 at 11:18
  • 2
    better yet create an alias in your bash profile and use a shorter keyword/command to clean up stopped containers – Yogesh_D Jan 20 '16 at 08:23
  • 24
    "docker container prune" can be used since 1.25 I believe to remove stopped containers – paul Sep 29 '17 at 10:57
51

The typical command is:

docker container ls -f 'status=exited'

However, this will only list one of the possible non-running statuses. Here's a list of all possible statuses:

  • created
  • restarting
  • running
  • removing
  • paused
  • exited
  • dead

You can filter on multiple statuses by passing multiple filters on the status:

docker container ls -f 'status=exited' -f 'status=dead' -f 'status=created'

If you are integrating this with an automatic cleanup script, you can chain one command to another with some bash syntax, output just the container id's with -q, and you can also limit to just the containers that exited successfully with an exit code filter:

docker container rm $(docker container ls -q -f 'status=exited' -f 'exited=0')

For more details on filters you can use, see Docker's documentation: https://docs.docker.com/engine/reference/commandline/ps/#filtering

BMitch
  • 188,157
  • 34
  • 411
  • 383
19
docker container list -f "status=exited"

or

docker container ls -f "status=exited"

or 

 docker ps -f "status=exited"
Artur Karbone
  • 1,291
  • 11
  • 11