0a0dd116 |
% DOCKER(1) Docker User Manuals |
b07f1938 |
% Docker Community
% JUNE 2014 |
0a0dd116 |
# NAME |
b07f1938 |
docker-import - Create an empty filesystem image and import the contents of the tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then optionally tag it. |
0a0dd116 |
# SYNOPSIS |
b07f1938 |
**docker import** |
d79860af |
[**-c**|**--change**[=*[]*]] |
936b2c6a |
[**-m**|**--message**[=*MESSAGE*]] |
a2b529ea |
[**--help**] |
d79860af |
file|URL|**-**[REPOSITORY[:TAG]] |
0a0dd116 |
|
17abfc3d |
# OPTIONS
**-c**, **--change**=[]
Apply specified Dockerfile instructions while importing the image |
49be8484 |
Supported Dockerfile instructions: `CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR` |
17abfc3d |
|
d79860af |
**--help**
Print usage statement
|
936b2c6a |
**-m**, **--message**=""
Set commit message for imported image
|
0a0dd116 |
# DESCRIPTION |
e02cf697 |
Create a new filesystem image from the contents of a tarball (`.tar`,
`.tar.gz`, `.tgz`, `.bzip`, `.tar.xz`, `.txz`) into it, then optionally tag it. |
0a0dd116 |
|
b07f1938 |
|
0a0dd116 |
# EXAMPLES
## Import from a remote location
# docker import http://example.com/exampleimage.tgz example/imagerepo
## Import from a local file
Import to docker via pipe and stdin:
# cat exampleimage.tgz | docker import - example/imagelocal
|
877e6d76 |
Import with a commit message. |
936b2c6a |
# cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new
|
3f64b76d |
Import to a Docker image from a local file.
# docker import /path/to/exampleimage.tgz
|
0a0dd116 |
## Import from a local file and tag
Import to docker via pipe and stdin:
# cat exampleimageV2.tgz | docker import - example/imagelocal:V-2.0
## Import from a local directory
# tar -c . | docker import - exampleimagedir
|
17abfc3d |
## Apply specified Dockerfile instructions while importing the image
This example sets the docker image ENV variable DEBUG to true by default.
# tar -c . | docker import -c="ENV DEBUG true" - exampleimagedir
|
cbb149f5 |
# See also
**docker-export(1)** to export the contents of a filesystem as a tar archive to STDOUT.
|
0a0dd116 |
# HISTORY
April 2014, Originally compiled by William Henry (whenry at redhat dot com) |
fa29b1f0 |
based on docker.com source material and internal work. |
b07f1938 |
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> |