podman-history(1)

💖 podman-history(1) 💖

okay bestie, welcome to the General Commands Manual glow-up edition, this is podman-history and she's here to spill all the tea about your image layers 🫖✨

---

✨ NAME ✨

podman-history — Show the history of an image 👑

---

🌸 SYNOPSIS 🌸

podman history [options] image[:tag|@digest]

podman image history [options] image[:tag|@digest]

---

🦋 DESCRIPTION 🦋

so like, podman history shows you the history of an image by printing out the deets on every single layer used in that image. the receipts, fr fr 🧾

for each layer it prints out Created (that's the time and date), Created By, Size, and Comment. that's the whole lineup, no gatekeeping.

the output can be truncated or not using the --no-trunc flag. and if the --human flag is set, the time of creation and the size get printed in a human readable format (so like, not a scary raw timestamp, we love that for us 💅).

the --quiet flag displays the ID of the image only when set, and the --format flag is used to print the info using the Go template that you provide. yes you, main character, you get to pick 🎀

---

💅 OPTIONS 💅

🌈 --format=format

alters the output for a format like 'json' or a Go template.

the valid placeholders for the Go template are listed below, memorize them bestie (or don't, this page exists):

• .Comment — Comment for the layer
• .Created — if --human, time elapsed since creation, otherwise time stamp of creation
• .CreatedAt — Time when the image layer was created
• .CreatedBy — Command used to create the layer
• .CreatedSince — Elapsed time since the image layer was created
• .ID — Image ID
• .Size — Size of layer on disk
• .Tags — Image tags

🎀 --help, -h

Print usage statement

🌸 --human, -H

Display sizes and dates in human readable format (default true).

✨ --no-trunc

Do not truncate the output (default false).

💜 --quiet, -q

Print the numeric IDs only (default false).

---

🍓 EXAMPLES 🍓

Show the history of the specified image:

$ podman history debian
ID              CREATED       CREATED BY                                      SIZE       COMMENT
b676ca55e4f2c   9 weeks ago   /bin/sh -c #(nop) CMD ["bash"]                  0 B
<missing>       9 weeks ago   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45.14 MB

Show the history of the specified image without truncating content and using raw data:

$ podman history --no-trunc=true --human=false debian
ID              CREATED                CREATED BY                                      SIZE       COMMENT
b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop) CMD ["bash"]                  0
<missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45142935

Show the formatted history of the specified image:

$ podman history --format "{{.ID}} {{.Created}}" debian
b676ca55e4f2c   9 weeks ago
<missing>       9 weeks ago

Show the history in JSON format for the specified image:

$ podman history --format json debian
[
    {
     "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
     "created": "2017-07-24T16:52:55.195062314Z",
     "createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
     "size": 0,
     "comment": ""
    },
    {
     "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
     "created": "2017-07-24T16:52:54.898893387Z",
     "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
     "size": 45142935,
     "comment": ""
    }
]

---

👑 SEE ALSO 👑

• podman(1)

---

💖 HISTORY 💖

July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩

---

and that's the whole page bestie, we ate and left no crumbs 🔥 this was podman-history(1) straight outta the General Commands Manual, dated all the way back to July 2017 — iconic behavior honestly, periodt 💅✨🦋