docker image import

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

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

© 2013–2016 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/engine/reference/commandline/image_import/