github.com/kaisenlinux/docker.io@v0.0.0-20230510090727-ea55db55fac7/cli/man/src/image/history.md (about)

     1  Show the history of when and how an image was created.
     2  
     3  # EXAMPLES
     4      $ docker history fedora
     5      IMAGE          CREATED          CREATED BY                                      SIZE                COMMENT
     6      105182bb5e8b   5 days ago       /bin/sh -c #(nop) ADD file:71356d2ad59aa3119d   372.7 MB
     7      73bd853d2ea5   13 days ago      /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar   0 B
     8      511136ea3c5a   10 months ago                                                    0 B                 Imported from -
     9  
    10  ## Display comments in the image history
    11  The `docker commit` command has a **-m** flag for adding comments to the image. These comments will be displayed in the image history.
    12  
    13      $ sudo docker history docker:scm
    14      IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
    15      2ac9d1098bf1        3 months ago        /bin/bash                                       241.4 MB            Added Apache to Fedora base image
    16      88b42ffd1f7c        5 months ago        /bin/sh -c #(nop) ADD file:1fd8d7f9f6557cafc7   373.7 MB            
    17      c69cab00d6ef        5 months ago        /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar   0 B                 
    18      511136ea3c5a        19 months ago                                                       0 B                 Imported from -
    19  
    20  ### Format the output
    21  
    22  The formatting option (`--format`) will pretty-prints history output
    23  using a Go template.
    24  
    25  Valid placeholders for the Go template are listed below:
    26  
    27  | Placeholder     | Description |
    28  | --------------- | ----------- |
    29  | `.ID`           | Image ID    |
    30  | `.CreatedSince` | Elapsed time since the image was created if `--human=true`, otherwise timestamp of when image was created |
    31  | `.CreatedAt`    | Timestamp of when image was created |
    32  | `.CreatedBy`    | Command that was used to create the image |
    33  | `.Size`         | Image disk size |
    34  | `.Comment`      | Comment for image |
    35  
    36  When using the `--format` option, the `history` command will either
    37  output the data exactly as the template declares or, when using the
    38  `table` directive, will include column headers as well.
    39  
    40  The following example uses a template without headers and outputs the
    41  `ID` and `CreatedSince` entries separated by a colon for all images:
    42  
    43  ```bash
    44  $ docker images --format "{{.ID}}: {{.CreatedSince}} ago"
    45  
    46  cc1b61406712: 2 weeks ago
    47  <missing>: 2 weeks ago
    48  <missing>: 2 weeks ago
    49  <missing>: 2 weeks ago
    50  <missing>: 2 weeks ago
    51  <missing>: 3 weeks ago
    52  <missing>: 3 weeks ago
    53  <missing>: 3 weeks ago
    54  ```