1podman-history(1)           General Commands Manual          podman-history(1)
2
3
4

NAME

6       podman-history - Show the history of an image
7
8

SYNOPSIS

10       podman history [options] image[:tag|@digest]
11
12

DESCRIPTION

14       podman history displays the history of an image by printing out
15       information about each layer used in the image. The information printed
16       out for each layer include Created (time and date), Created By, Size,
17       and Comment. The output can be truncated or not using the --no-trunc
18       flag. If the --human flag is set, the time of creation and size are
19       printed out in a human readable format.  The --quiet flag displays the
20       ID of the image only when set and the --format flag is used to print
21       the information using the Go template provided by the user.
22
23
24       Valid placeholders for the Go template are listed below:
25
26
27       ┌────────────┬────────────────────────────┐
28       │Placeholder │ Description                │
29       ├────────────┼────────────────────────────┤
30       │.ID         │ Image ID                   │
31       ├────────────┼────────────────────────────┤
32       │.Created    │ if --human, time elapsed   │
33       │            │ since creation, otherwise  │
34       │            │ time stamp of creation     │
35       ├────────────┼────────────────────────────┤
36       │.CreatedBy  │ Command used to create the │
37       │            │ layer                      │
38       ├────────────┼────────────────────────────┤
39       │.Size       │ Size of layer on disk      │
40       ├────────────┼────────────────────────────┤
41       │.Comment    │ Comment for the layer      │
42       └────────────┴────────────────────────────┘
43

OPTIONS

45       --human, -H
46
47
48       Display sizes and dates in human readable format
49
50
51       --no-trunc
52
53
54       Do not truncate the output
55
56
57       --quiet, -q
58
59
60       Print the numeric IDs only
61
62
63       --format
64
65
66       Alter the output for a format like 'json' or a Go template.
67
68
69       --help, -h
70
71
72       Print usage statement
73
74

EXAMPLES

76              $ podman history debian
77              ID              CREATED       CREATED BY                                      SIZE       COMMENT
78              b676ca55e4f2c   9 weeks ago   /bin/sh -c #(nop) CMD ["bash"]                  0 B
79              <missing>       9 weeks ago   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45.14 MB
80
81
82
83              $ podman history --no-trunc=true --human=false debian
84              ID              CREATED                CREATED BY                                      SIZE       COMMENT
85              b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop) CMD ["bash"]                  0
86              <missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45142935
87
88
89
90              $ podman history --format "{{.ID}} {{.Created}}" debian
91              b676ca55e4f2c   9 weeks ago
92              <missing>       9 weeks ago
93
94
95
96              $ podman history --format json debian
97              [
98                  {
99                          "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
100                          "created": "2017-07-24T16:52:55.195062314Z",
101                          "createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
102                          "size": 0,
103                          "comment": ""
104                  },
105                  {
106                          "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
107                          "created": "2017-07-24T16:52:54.898893387Z",
108                          "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
109                          "size": 45142935,
110                          "comment": ""
111                  }
112              ]
113
114
115

SEE ALSO

117       podman(1)
118
119

HISTORY

121       July 2017, Originally compiled by Urvashi Mohnani ⟨umohnani@redhat.com⟩
122
123
124
125                                                             podman-history(1)