NAME

       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.

SYNOPSIS

       docker import [-c|--change[= []]] [--help**] URL|- [REPOSITORY[:TAG]]

OPTIONS

       -c, --change=[]
          Apply specified Dockerfile instructions while importing the image
          Supported                           Dockerfile                            instructions:
       ADD|CMD|ENTRYPOINT|ENV|EXPOSE|FROM|MAINTAINER|RUN|USER|LABEL|VOLUME|WORKDIR|COPY

DESCRIPTION

       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.

OPTIONS

       --help
         Print usage statement

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

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

See also

       docker-export(1) to export the contents of a filesystem as a tar archive to STDOUT.

HISTORY

       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
       ⟨SvenDowideit@home.org.au⟩