mirror of
https://github.com/docker/cli.git
synced 2026-08-31 18:14:29 -05:00
Daniel YC Lin
c0c3fbc7b6
Upstream-commit: 8f6b6d57840410d1491321d7681ef2a946e90bc9 Component: engine
42 lines
1.4 KiB
ReStructuredText
42 lines
1.4 KiB
ReStructuredText
:title: Import Command
|
|
:description: Create a new filesystem image from the contents of a tarball
|
|
:keywords: import, tarball, docker, url, documentation
|
|
|
|
==========================================================================
|
|
``import`` -- Create a new filesystem image from the contents of a tarball
|
|
==========================================================================
|
|
|
|
::
|
|
|
|
Usage: docker import URL|- [REPOSITORY [TAG]]
|
|
|
|
Create a new filesystem image from the contents of a tarball
|
|
|
|
At this time, the URL must start with ``http`` and point to a single file archive
|
|
(.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz)
|
|
containing a root filesystem. If you would like to import from a local directory or archive,
|
|
you can use the ``-`` parameter to take the data from standard in.
|
|
|
|
Examples
|
|
--------
|
|
|
|
Import from a remote location
|
|
.............................
|
|
|
|
``$ docker import http://example.com/exampleimage.tgz exampleimagerepo``
|
|
|
|
Import from a local file
|
|
........................
|
|
|
|
Import to docker via pipe and standard in
|
|
|
|
``$ cat exampleimage.tgz | docker import - exampleimagelocal``
|
|
|
|
Import from a local directory
|
|
.............................
|
|
|
|
``$ sudo tar -c . | docker import - exampleimagedir``
|
|
|
|
Note the ``sudo`` in this example -- you must preserve the ownership of the files (especially root ownership)
|
|
during the archiving with tar. If you are not root (or sudo) when you tar, then the ownerships might not get preserved.
|