podman-system-df(1)

💖 podman-system-df — Show podman disk usage 💖

okay bestie, this is podman-system-df from the General Commands Manual, and it's literally just your lil disk-usage detective 🕵️‍♀️✨

---

✨ SYNOPSIS ✨

podman system df [options]

---

🌸 DESCRIPTION 🌸

It shows you podman disk usage for images, containers and volumes. That's the whole vibe. 🦋

⚠️ Note: the RECLAIMABLE size that gets reported for images can be incorrect. It might tell you it can reclaim more than a prune would actually free. This happens if you're using different images that share some layers. So don't come for me when the numbers don't match, it's not me it's the shared layers 💀

---

💅 OPTIONS 💅

• --format=format — Pretty-print images using a Go template or JSON. This flag is not allowed in combination with --verbose. no cap. 🙈

Valid placeholders for the Go template are listed below:

• .Active — Indicates whether volume is in use
• .RawReclaimable — Raw reclaimable size of each Type
• .RawSize — Raw size of each type
• .Reclaimable — Reclaimable size or each type (human-readable)
• .Size — Size of each type (human-readable)
• .Total — Total items for each type
• .Type — Type of data

• --verbose, -v — Show detailed information on space usage

---

🎀 EXAMPLE 🎀

Show disk usage:

$ podman system df
TYPE            TOTAL   ACTIVE   SIZE    RECLAIMABLE
Images          6       2        281MB   168MB (59%)
Containers      3       1        0B      0B (0%)
Local Volumes   1       1        22B     0B (0%)

Show disk usage in verbose mode:

$ podman system df -v
Images space usage:

REPOSITORY                 TAG      IMAGE ID       CREATED       SIZE     SHARED SIZE   UNIQUE SIZE   CONTAINERS
docker.io/library/alpine   latest   5cb3aa00f899   2 weeks ago   5.79MB   0B            5.79MB       5

Containers space usage:

CONTAINER ID    IMAGE   COMMAND       LOCAL VOLUMES   SIZE     CREATED        STATUS       NAMES
073f7e62812d    5cb3    sleep 100     1               0B       20 hours ago   exited       zen_joliot
3f19f5bba242    5cb3    sleep 100     0               5.52kB   22 hours ago   exited       pedantic_archimedes
8cd89bf645cc    5cb3    ls foodir     0               58B      21 hours ago   configured   agitated_hamilton
a1d948a4b61d    5cb3    ls foodir     0               12B      21 hours ago   exited       laughing_wing
eafe3e3c5bb3    5cb3    sleep 10000   0               72B      21 hours ago   exited       priceless_liskov

Local Volumes space usage:

VOLUME NAME   LINKS   SIZE
data          1       0B

Show only the total count for each type:

$ podman system df --format "{{.Type}}\t{{.Total}}"
Images          1
Containers      5
Local Volumes   1

Show disk usage in JSON format:

$ podman system df --format json
[
    {"Type":"Images","Total":12,"Active":3,"RawSize":13491151377,"RawReclaimable":922956674,"TotalCount":12,"Size":"13.49GB","Reclaimable":"923MB (7%)"},
    {"Type":"Containers","Total":4,"Active":0,"RawSize":209266,"RawReclaimable":209266,"TotalCount":4,"Size":"209.3kB","Reclaimable":"209.3kB (100%)"},
    {"Type":"Local Volumes","Total":6,"Active":1,"RawSize":796638905,"RawReclaimable":47800633,"TotalCount":6,"Size":"796.6MB","Reclaimable":"47.8MB (6%)"}
]

Show type and size in a custom format:

$ podman system df --format "{{.Type}}: {{.Size}} ({{.Reclaimable}} reclaimable)"

Images: 13.49GB (923MB (7%) reclaimable)
Containers: 209.3kB (209.3kB (100%) reclaimable)
Local Volumes: 796.6MB (47.8MB (6%) reclaimable)

---

👀 SEE ALSO 👀

podman(1), podman-system(1)

---

📜 HISTORY 📜

March 2019, Originally compiled by Qi Wang (qiwan at redhat dot com)

---

and that's the whole page bestie 💜 it's podman-system-df(1) from the General Commands Manual, and it said its lil goodbye at the bottom as podman-system-df(1) — March 2019 energy, Qi Wang ate that 🫶✨