docker image import

Estimated reading time: 3 minutes

Description

Import the contents from a tarball to create a filesystem image

Usage

docker image import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]

Options

Name, shorthand Default Description
--change, -c   Apply Dockerfile instruction to the created image
--message, -m   Set commit message for imported image

Parent command

Command Description
docker image Manage images
Command Description
docker image build Build an image from a Dockerfile
docker image history Show the history of an image
docker image import Import the contents from a tarball to create a filesystem image
docker image inspect Display detailed information on one or more images
docker image load Load an image from a tar archive or STDIN
docker image ls List images
docker image prune Remove unused images
docker image pull Pull an image or a repository from a registry
docker image push Push an image or a repository to a registry
docker image rm Remove one or more images
docker image save Save one or more images to a tar archive (streamed to STDOUT by default)
docker image tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE

Extended 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 image import http://example.com/exampleimage.tgz example/imagerepo

Import from a local file

Import to docker via pipe and stdin:

# cat exampleimage.tgz | docker image import - example/imagelocal

Import with a commit message.

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

Import to a Docker image from a local file.

# docker image import /path/to/exampleimage.tgz 

Import from a local file and tag

Import to docker via pipe and stdin:

# cat exampleimageV2.tgz | docker image import - example/imagelocal:V-2.0

Import from a local directory

# tar -c . | docker image 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 image import -c="ENV DEBUG true" - exampleimagedir

See also

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

Examples

Import from a remote location

# docker image import http://example.com/exampleimage.tgz example/imagerepo

Import from a local file

Import to docker via pipe and stdin:

# cat exampleimage.tgz | docker image import - example/imagelocal

Import with a commit message.

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

Import to a Docker image from a local file.

# docker image import /path/to/exampleimage.tgz

Import from a local file and tag

Import to docker via pipe and stdin:

# cat exampleimageV2.tgz | docker image import - example/imagelocal:V-2.0

Import from a local directory

# tar -c . | docker image 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 image import -c="ENV DEBUG true" - exampleimagedir
chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support
Rate this page: