Skip to content

[Request]: Storage - Add container system df command to show storage usage for images, containers, and volumes #884

@realrajaryan

Description

@realrajaryan

Feature or enhancement request details

Add a container system df subcommand to display disk usage across images, containers, and volumes. This would provide a quick overview of storage utilization and reclaimable space within the container system.

Some basic requirements:

  • Report actual on-disk capacity used by each resource type
  • Account for APFS clones to avoid double-counting shared data
  • Include reclaimable space metrics for unused or dangling data

Example output:

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          10        5         15.2GB    8.1GB
Containers      8         3         2.4GB     1.8GB
Volumes         5         2         42.8GB    12.3GB

This would help users audit storage usage and identify cleanup opportunities.

We should have more discussion about what we can add/do better here. For example, how to:

  • Show per-resource details (e.g. top N largest images or volumes)
  • Handle reporting for shared layers or deduplicated data under APFS
  • Optionally expose low-level stats (block usage, clone counts, etc.) for debugging

Code of Conduct

  • I agree to follow this project's Code of Conduct

Metadata

Metadata

Assignees

Labels

nextMust-have items for current and next milestonestorageissues and features associated with storage.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions