Skip to content

docker images

Lists the images stored on the host.

docker-images output

Syntax

docker images [OPTIONS] [NAME[:TAG]]

Options

Option Description
NAME[:TAG] Only images with this name, such as nginx
-a, --all Also show intermediate images
-q, --quiet Only the image IDs
-f, --filter FILTER Filter, such as dangling=true (images without a name)
--digests Also show the digest (the exact fingerprint of the image)
--format TEMPLATE Choose the columns

docker image ls is the same command under its newer name.

Examples

List all images:

docker images
IMAGE             ID             DISK USAGE   CONTENT SIZE   EXTRA
nginx:1.28        146adea4768b        239MB         65.8MB   U
postgres:17       b8faeff77126        643MB          167MB   U
status-page:1.0   ffca3ce5b5cf        237MB         62.9MB

U in the EXTRA column means the image is in use by a container. DISK USAGE is the unpacked size on disk, CONTENT SIZE the compressed download.

Only the images of one name:

docker images nginx
IMAGE        ID             DISK USAGE   CONTENT SIZE   EXTRA
nginx:1.28   146adea4768b        239MB         65.8MB   U
nginx:1.27   5ed8fcc66f4e        236MB         64.9MB

Images without a name (left over after builds):

docker images -f dangling=true -q
3b9c4f7e21a0

When do I need it?

  • To see which images and versions are on the server
  • To find out how much space the images take up
  • Before cleaning up, to find old and unused images

Older Docker versions look different

Before Docker 29, docker images showed the columns REPOSITORY, TAG, IMAGE ID, CREATED and SIZE. The docker.io packages of Debian and Ubuntu still show this layout.

docker pull · docker rmi · docker build · docker system