0a0dd116 |
% DOCKER(1) Docker User Manuals |
b07f1938 |
% Docker Community
% JUNE 2014 |
0a0dd116 |
# NAME |
b07f1938 |
docker-commit - Create a new image from a container's changes |
0a0dd116 |
# SYNOPSIS |
b07f1938 |
**docker commit**
[**-a**|**--author**[=*AUTHOR*]] |
ab9e71b6 |
[**-c**|**--change**[=\[*DOCKERFILE INSTRUCTIONS*\]]] |
14e88986 |
[**--help**] |
b07f1938 |
[**-m**|**--message**[=*MESSAGE*]] |
5743cc34 |
[**-p**|**--pause**[=*true*]] |
e01baa6b |
CONTAINER [REPOSITORY[:TAG]] |
0a0dd116 |
# DESCRIPTION |
a9747895 |
Create a new image from an existing container specified by name or
container ID. The new image will contain the contents of the |
ea98cf74 |
container filesystem, *excluding* any data volumes. Refer to **docker-tag(1)**
for more information about valid image and tag names. |
a9747895 |
While the `docker commit` command is a convenient way of extending an
existing image, you should prefer the use of a Dockerfile and `docker
build` for generating images that you intend to share with other
people. |
0a0dd116 |
# OPTIONS |
b07f1938 |
**-a**, **--author**=""
Author (e.g., "John Hannibal Smith <hannibal@a-team.com>") |
0a0dd116 |
|
5767548f |
**-c** , **--change**=[] |
17abfc3d |
Apply specified Dockerfile instructions while committing the image |
0bf0e5a6 |
Supported Dockerfile instructions: `CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`LABEL`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR` |
5767548f |
|
a2b529ea |
**--help**
Print usage statement
|
b07f1938 |
**-m**, **--message**="" |
0a0dd116 |
Commit message
|
5743cc34 |
**-p**, **--pause**=*true*|*false*
Pause container during commit. The default is *true*. |
957c510d |
|
0a0dd116 |
# EXAMPLES
## Creating a new image from an existing container |
bbde4298 |
An existing Fedora based container has had Apache installed while running |
0a0dd116 |
in interactive mode with the bash shell. Apache is also running. To |
809d99ad |
create a new image run `docker ps` to find the container's ID and then run: |
0a0dd116 |
|
a52441b1 |
# docker commit -m="Added Apache to Fedora base image" \ |
8f99875d |
-a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20 |
0a0dd116 |
|
05a86905 |
Note that only a-z0-9-_. are allowed when naming images from an
existing container.
|
17abfc3d |
## Apply specified Dockerfile instructions while committing the image
If an existing container was created without the DEBUG environment
variable set to "true", you can create a new image based on that |
809d99ad |
container by first getting the container's ID with `docker ps` and |
17abfc3d |
then running: |
5767548f |
# docker commit -c="ENV DEBUG true" 98bd7fc99854 debug-image
|
0a0dd116 |
# HISTORY
April 2014, Originally compiled by William Henry (whenry at redhat dot com) |
fa29b1f0 |
based on docker.com source material and in |
b07f1938 |
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> |
5743cc34 |
July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> |
5767548f |
Oct 2014, updated by Daniel, Dao Quang Minh <daniel at nitrous dot io> |
05a86905 |
June 2015, updated by Sally O'Malley <somalley@redhat.com> |