Skip to content

docs: clarify docker system df --format placeholders - #7138

Open
locker95 wants to merge 1 commit into
docker:masterfrom
locker95:docs/system-df-format-fields
Open

docs: clarify docker system df --format placeholders#7138
locker95 wants to merge 1 commit into
docker:masterfrom
locker95:docs/system-df-format-fields

Conversation

@locker95

Copy link
Copy Markdown

--format on docker system df only formats the summary rows. People keep trying .ID / image-style fields (often copied from elsewhere) and get confusing template errors.

This spells out the real placeholders, includes Build Cache in .Type, and notes that --verbose ignores --format.

Fixes #3749

Document summary-row fields (including Build Cache) and call out that
image/container style placeholders like .ID are not valid for the
non-verbose formatter.

Fixes docker#3749

Signed-off-by: Dean Chen <862469039@qq.com>
@locker95
locker95 requested review from a team and thaJeztah as code owners July 30, 2026 13:39
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement or add documentation about docker system df --format

2 participants