# docker images: List Images, Filters & Formatting

> How docker images works: listing local images, filtering dangling layers, custom formatting, and using it to debug disk usage in CI.

Source: https://latchkey.dev/learn/command-reference/docker-images-command  
Updated: 2026-06-25

List the images on the host, with filters and formatting for scripts.

docker images (alias docker image ls) lists images stored locally. This page covers filtering, formatting, and using it to find disk hogs in CI.

## What it does

docker images shows the repository, tag, image ID, creation time, and size of each local image. It is the read-only counterpart to docker rmi.

## Common usage

```Terminal
docker images
docker images -a                       # include intermediate layers
docker images --filter "dangling=true"
docker images --format "{{.Repository}}:{{.Tag}} {{.Size}}"
docker images node --filter "reference=node:20*"
```

## Common errors in CI

docker images rarely errors, but it is the tool you reach for when a build fails with "no space left on device": run docker images and docker system df to see which images dominate disk, then docker image prune -af. A common confusion: --filter "dangling=true" only shows untagged layers; to free space from tagged-but-unused images, prune with docker image prune -a.

## FAQ

### docker images: List Images, Filters & Formatting?

docker images (alias docker image ls) lists images stored locally. This page covers filtering, formatting, and using it to find disk hogs in CI.

### What it does?

docker images shows the repository, tag, image ID, creation time, and size of each local image. It is the read-only counterpart to docker rmi.

### Common errors in CI?

docker images rarely errors, but it is the tool you reach for when a build fails with "no space left on device": run docker images and docker system df to see which images dominate disk, then docker image prune -af.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt