DOCKER(1)                     Docker User Manuals                    DOCKER(1)



<?><?><?> (NAME)
       docker-image-import - <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> tarball <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       docker image import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]



<?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> tarball
       (.tar<?> .tar.gz<?> .tgz<?> .bzip<?> .tar.xz<?> .txz) <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
<?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       (Import from a remote location)
       # docker image import http://example.com/exampleimage.tgz example/imagerepo


<?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> (Import from
       a local file)
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> stdin:

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


       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       (commit message).

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


       <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?>.

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


<?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> (Import from a local file and tag)
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> stdin:

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


<?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (Import from a local directory)
       # tar -c . | docker image import - exampleimagedir


<?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> Dockerfile <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> (Apply specified Dockerfile instructions
       while importing the image)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> ENV <?><?><?><?>
       <?><?> <?><?><?> DEBUG <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> true <?><?><?><?><?> <?><?><?><?><?><?>.

       # tar -c . | docker image import -c="ENV DEBUG=true" - exampleimagedir


<?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (When the daemon supports multiple operating
       systems)
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> --platform <?><?><?><?>. <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       # docker image import --platform=linux .\linuximage.tar



<?><?><?><?><?><?> (See also)
       docker-export(1) <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> tar <?><?> STDOUT.



<?><?><?><?><?><?><?><?> (OPTIONS)
       -c, --change=  <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       Dockerfile <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>


       -m, --message=""    <?><?><?><?><?> <?><?><?><?> <?><?><?> (commit
       message) <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>


       --platform=""  <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>



<?><?><?><?><?><?> (SEE ALSO)
       docker-image(1)

Docker Community                   Aug 2026                          DOCKER(1)