How to use docker images filter - docker

Question

I can write
docker images --filter "dangling=true"
What other filters can I use?
I can use something like this?
docker images --filter "running=false"

Answer 1

Docker v1.13.0 supports the following conditions:
-f, --filter value Filter output based on conditions provided (default [])
- dangling=(true|false)
- label=<key> or label=<key>=<value>
- before=(<image-name>[:tag]|<image-id>|<image#digest>)
- since=(<image-name>[:tag]|<image-id>|<image#digest>)
- reference=(pattern of an image reference)
Or use grep to filter images by some value:
$ docker images | grep somevalue
References
docker images filtering
docker docs

Answer 2

You can also use the REPOSITORY argument to docker images to filter the images.
For example, suppose we have the images:
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
local-foo latest 17864104b328 2 months ago 100 MB
example.com/bar latest b94c37de2801 9 months ago 285 MB
example.com/baz latest a004e3ac682c 2 years ago 221 MB
We can explicitly filter for all images with a given name:
$ docker images example.com/bar
REPOSITORY TAG IMAGE ID CREATED SIZE
example.com/bar latest b94c37de2801 9 months ago 285 MB
Docker also supports globbing:
$ docker images "example.com/*"
REPOSITORY TAG IMAGE ID CREATED SIZE
example.com/bar latest b94c37de2801 9 months ago 285 MB
example.com/baz latest a004e3ac682c 2 years ago 221 MB
Official docs here.

Answer 3

In Docker v1.7:
The currently supported filters are:
dangling (boolean - true or false)
label (label=<key> or label=<key>=<value>)

Answer 4

For me,
docker images -q | while read IMAGE_ID; do
docker inspect --format='{{.Created}}' --type=image ${IMAGE_ID}
done
did the trick. The date command is able to produce output in the same format via
date -Ins --date='10 weeks ago'
which allows me to compare timestamps. I still use the filter for dangling images for convenience, though.

Answer 5

I'm wanted to find a match for both local images and images that were tagged with a remote repo (my-repo.example.com in example below).
For example,
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
my-good-app latest 9a8742ad82d3 24 hours ago 126MB
my-repo.example.com/mine/my-good-app latest 9a8742ad82d3 24 hours ago 126MB
my-repo.example.com/mine/demo-docker latest c10baf5231a1 2 weeks ago 200MB
I got tired of trying to figure out how filtering worked, so I just fell back to what I knew.
docker images | grep my-good-app | awk '{print $3}' | uniq
This would match any image names that had the pattern my-good-app. I could not get other answers to include both (images without a repo and images with a reponame like my-repo.example.com in my example).
Then to delete the images matched above, I ran:
docker rmi -f $(docker images | grep my-good-app | awk '{print $3}' | uniq)

Answer 6

sudo docker images --filter "running=false"
For cleaning up old stopped containers you can use:
docker container prune
To remove untagged images you can use:
docker image prune

Answer 7

Docker CLI lacks in the proper filtering if you're looking for a solution to remove images based on both the creation date and repository / tag:
docker image prune does accept the timestamps via --since and --until flags (e.g.: --until=24h), but does not allow filtering by repo/tag.
docker images and docker image ls does accept the repo/tag filters (e.g.: --filter=reference='registry.gitlab.com/group/*/*) but does not accept timestamps - only other images ids in --since and --before (e.g. --since=586026f10754)
I wrote a (seven-lines) one-liner for what I believe is a common need: removing images based on both their repo and creation date. Here you go:
docker image rm $(docker images \
--filter=reference='registry.gitlab.com/group/*/*/*:*' \
--format "{{.ID}}-{{.CreatedAt}}'" | \
cut -d " " -f 1 | \
sed 's/-/ /'| \
awk -v date="$(date --date='3 days ago' +%Y-%m-%d)" '$NF < date' \
cut -d " " -f 1)
Customizations:
Name filtering: 2nd line, value of reference= - see docs
Date filtering: 6th line, value of date= - see docs
Requirements: bash, awk, cut, sed and obviously docker.

Answer 8

In Powershell use this example:
docker images --format "{{.Repository}}:{{.Tag}}" | findstr "some_name"
To delete images you can combine this with the delete command like so:
docker rmi $(docker images --format "{{.Repository}}:{{.Tag}}"|findstr "some_name")

Answer 9

To add to the original answer on how to use images filter, just to add a use case for a similar scenario.
My CI pipeline re-builds docker and tags them with last commit number every time, sends them to docker repository.
However, this results in residual & un-used/un-wanted images on the CI build machine.
As a post step, I need to clean them up all, even the ones build just now, but at the same time, want to leave my base downloaded images ( such as OpenJDK, PostGre ) un-deleted to avoid download every time
Add a/any label in Docker file ( unique and is not expected to be contained in my base images)
LABEL built=XYZ
Using images filter and just to get the image identifiersfor the images I created
docker images --quiet --filter label=built=XYZ
Delete them as a post build action
docker rmi -f $(docker images --quiet --filter label=built=XYZ)

Answer 10

There's another example, works with version 17.09++:
sudo docker rmi $(sudo docker images -f=reference="registry.gitlab.com/example-app" -f "dangling=true" -q)
Explanation:
reference - we are referencing images by repository name;
dangling=true - we are removing untagged images;
-q - means quiet, showing only numeric IDs of images, instead of a whole line.
This command removes all images that have a repository name "registry.gitlab.com/example-app" and untagged (have <none> in a tag column)
Reference link: https://docs.docker.com/engine/reference/commandline/images/#filtering

Answer 11

Docker builtin filtering feature simply doesn't cut it for certain use cases. Mainly, the glob pattern not matching the forward slash makes it impossible to match images not sharing the same count of forward slashes.
I find it's easier to rely on an external tool such as awk. For example, here I'm pulling/updating all the images from a certain repository and its subdirectories tagged with any SNAPSHOT version :
docker images --filter=since=65f20cac3aa5 | awk '$1~repo && $2~tag { print $1 ":" $2}' repo=my.repo.com/subdirectory tag=SNAPSHOT | xargs -r -L 1 docker pull
Notice that I combined it with the builtin filter "since".

Answer 12

FYI, without filter, but for delete all images when you use as testing or learning,
docker image rm -f $(docker image ls)
Greetings.