feat(image): adopt Docker v29 output for images list - #5093
Open
ekalinin wants to merge 1 commit into
Open
Conversation
AkihiroSuda
reviewed
Jul 22, 2026
ekalinin
force-pushed
the
feat/images-docker-v29-output
branch
2 times, most recently
from
July 23, 2026 19:00
14fd520 to
21a312d
Compare
Make the default `nerdctl images` output match Docker v29: a collapsed view with IMAGE, ID, DISK USAGE, CONTENT SIZE and EXTRA columns, an "In Use" (U) indicator, and <untagged> for dangling images. Multi-platform images are collapsed into a single row with aggregated disk and content size. Like Docker, the "In Use" legend is only printed when the output is a terminal, so piped and redirected output stays clean. The new view is used only for the bare command. Passing --format, --quiet, --no-trunc, --digests or --names falls back to the legacy table (REPOSITORY, TAG, IMAGE ID, CREATED, PLATFORM, SIZE, BLOB SIZE), so existing scripts and templates keep working. This mirrors Docker's own shouldUseTree fallback. Since the default output now matches Docker, the images tests also run against the Docker target; only the nerdctl-specific --names subtest stays gated. Tests that assert on the default `images` output for untagged images (image prune/remove and build-without-tag) are updated to expect <untagged>. The expanded per-platform `--tree` view is left for a follow-up. Closes containerd#5027 Signed-off-by: Eugene Kalinin <e.v.kalinin@gmail.com>
ekalinin
force-pushed
the
feat/images-docker-v29-output
branch
from
July 24, 2026 09:28
21a312d to
97dbfbd
Compare
AkihiroSuda
reviewed
Aug 1, 2026
| - IMAGE: Image reference ("repository:tag", "repository@digest", or "<untagged>") | ||
| - ID: OCI Digest. Usually different from Docker image ID. Shared for multi-platform images. | ||
| - DISK USAGE: Size of the unpacked snapshots | ||
| - CONTENT SIZE: Size of the blobs (such as layer tarballs) in the content store |
Member
There was a problem hiding this comment.
DISK USAGE and CONTENT SIZE seem to differ from Docker
$ docker images
i Info → U In Use
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
alpine:latest 28bd5fe8b56d 13.6MB 4.27MB
$ nerdctl images
i Info → U In Use
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
alpine:latest 28bd5fe8b56d 9.31MB 4.185MB Perhaps not a bug though
AkihiroSuda
reviewed
Aug 1, 2026
| Properties: | ||
| By default (Docker v29 compatible view) the following columns are shown: | ||
| - IMAGE: Image reference ("repository:tag", "repository@digest", or "<untagged>") | ||
| - ID: OCI Digest. Usually different from Docker image ID. Shared for multi-platform images. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Make the default
nerdctl imagesoutput match Docker v29: a collapsed view withIMAGE, ID, DISK USAGE, CONTENT SIZEandEXTRAcolumns, a legend line, an "In Use" (U) indicator, and<untagged>for dangling images. Multi-platform images are collapsed into a single row with aggregated disk and content size.The new view is used only for the bare command. Passing --format, --quiet, --no-trunc, --digests or --names falls back to the legacy table, so existing scripts and templates keep working. This mirrors Docker's own shouldUseTree fallback.
The expanded per-platform
--treeview is left for a follow-up.Closes #5027