docker-image-import
Import the contents from a tarball to create a filesystem image
- Provided by: docker.io (Version: 29.1.3-0ubuntu3~22.04.2)
- Source: docker.io-app
- Report a bug
Import the contents from a tarball to create a filesystem image
docker image import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]
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.
# docker image import http://example.com/exampleimage.tgz example/imagerepo
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 to docker via pipe and stdin:
# cat exampleimageV2.tgz | docker image import - example/imagelocal:V-2.0
# tar -c . | docker image import - exampleimagedir
This example sets the docker image ENV variable DEBUG to true by default.
# tar -c . | docker image import -c="ENV DEBUG=true" - exampleimagedir
If the daemon supports multiple operating systems, and the image being imported does not match the default operating system, it may be necessary to add --platform. This would be necessary when importing a Linux image into a Windows daemon.
# docker image import --platform=linux .\linuximage.tar
docker-export(1) to export the contents of a filesystem as a tar archive to STDOUT.
-c, --change= Apply Dockerfile instruction to the created image
-m, --message="" Set commit message for imported image
--platform="" Set platform if server is multi-platform capable