2014-04-16 18:07:55 +00:00
% DOCKER(1) Docker User Manuals
2014-07-01 02:58:04 +00:00
% Docker Community
% JUNE 2014
2014-04-16 18:07:55 +00:00
# NAME
2014-07-01 02:58:04 +00:00
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.
2014-04-16 18:07:55 +00:00
# SYNOPSIS
2014-07-01 02:58:04 +00:00
**docker import**
2015-02-05 11:26:05 +00:00
[**-c**|**--change**[= []**]]
2014-10-15 21:14:12 +00:00
[**--help**]
2014-07-01 02:58:04 +00:00
URL|- [REPOSITORY[:TAG]]
2014-04-16 18:07:55 +00:00
2015-02-05 11:26:05 +00:00
# OPTIONS
**-c**, ** --change**=[]
Apply specified Dockerfile instructions while importing the image
2015-03-17 04:49:33 +00:00
Supported Dockerfile instructions: `ADD` |`CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`FROM`|`MAINTAINER`|`RUN`|`USER`|`LABEL`|`VOLUME`|`WORKDIR`|`COPY`
2015-02-05 11:26:05 +00:00
2014-04-16 18:07:55 +00:00
# DESCRIPTION
2014-06-14 07:59:52 +00:00
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.
2014-04-16 18:07:55 +00:00
2014-07-01 02:58:04 +00:00
# OPTIONS
2014-10-15 21:14:12 +00:00
**--help**
Print usage statement
2014-07-01 02:58:04 +00:00
2014-04-16 18:07:55 +00:00
# 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
## 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
2015-02-05 11:26:05 +00:00
## 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
2015-03-05 01:21:38 +00:00
# See also
**docker-export(1)** to export the contents of a filesystem as a tar archive to STDOUT.
2014-04-16 18:07:55 +00:00
# HISTORY
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
2014-07-02 00:30:25 +00:00
based on docker.com source material and internal work.
2014-07-01 02:58:04 +00:00
June 2014, updated by Sven Dowideit < SvenDowideit @ home . org . au >