docker-latest-import (1) - Linux Man Pages

docker-latest-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.

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[=[]]] [-m|--message[=MESSAGE]] [--help] file|URL|-[REPOSITORY[:TAG]]

OPTIONS

-c, --change=[]
Apply specified Dockerfile instructions while importing the image
Supported Dockerfile instructions: CMD|ENTRYPOINT|ENV|EXPOSE|ONBUILD|USER|VOLUME|WORKDIR

--help
  Print usage statement

-m, --message=""
Set commit message for imported image

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.

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 with a commit message.

# cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new

Import to a Docker image from a local file.

# docker import /path/to/exampleimage.tgz 

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

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 [at] home.org.au>

See also

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