.TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "JUNE 2014"  ""


.SH NAME
.PP
docker\-history \- Show the history of an image


.SH SYNOPSIS
.PP
\fBdocker history\fP
[\fB\-\-help\fP]
[\fB\-H\fP|\fB\-\-human\fP[=\fItrue\fP]]
[\fB\-\-no\-trunc\fP]
[\fB\-q\fP|\fB\-\-quiet\fP]
IMAGE


.SH DESCRIPTION
.PP
Show the history of when and how an image was created.


.SH OPTIONS
.PP
\fB\-\-help\fP
  Print usage statement

.PP
\fB\-H\fP, \fB\-\-human\fP=\fItrue\fP|\fIfalse\fP
    Print sizes and dates in human readable format. The default is \fItrue\fP.

.PP
\fB\-\-no\-trunc\fP=\fItrue\fP|\fIfalse\fP
   Don't truncate output. The default is \fIfalse\fP.

.PP
\fB\-q\fP, \fB\-\-quiet\fP=\fItrue\fP|\fIfalse\fP
   Only show numeric IDs. The default is \fIfalse\fP.


.SH EXAMPLES
.PP
.RS

.nf
$ docker history fedora
IMAGE          CREATED          CREATED BY                                      SIZE                COMMENT
105182bb5e8b   5 days ago       /bin/sh \-c #(nop) ADD file:71356d2ad59aa3119d   372.7 MB
73bd853d2ea5   13 days ago      /bin/sh \-c #(nop) MAINTAINER Lokesh Mandvekar   0 B
511136ea3c5a   10 months ago                                                    0 B                 Imported from \-

.fi
.RE

.SH Display comments in the image history
.PP
The \fB\fCdocker commit\fR command has a \fB\-m\fP flag for adding comments to the image. These comments will be displayed in the image history.

.PP
.RS

.nf
$ sudo docker history docker:scm
IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
2ac9d1098bf1        3 months ago        /bin/bash                                       241.4 MB            Added Apache to Fedora base image
88b42ffd1f7c        5 months ago        /bin/sh \-c #(nop) ADD file:1fd8d7f9f6557cafc7   373.7 MB            
c69cab00d6ef        5 months ago        /bin/sh \-c #(nop) MAINTAINER Lokesh Mandvekar   0 B                 
511136ea3c5a        19 months ago                                                       0 B                 Imported from \-

.fi
.RE


.SH HISTORY
.PP
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
based on docker.com source material and internal work.
June 2014, updated by Sven Dowideit 
\[la][email protected]\[ra]