mirror of
https://github.com/docker/cli.git
synced 2026-08-30 18:14:19 -05:00
Andy Rothfusz
fd36c14020
Upstream-commit: d4eab77f0c604e10f63519833dc25fbd5a3419bf Component: engine
45 lines
1.4 KiB
ReStructuredText
45 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
|
|
.............................
|
|
|
|
``$ sudo docker import http://example.com/exampleimage.tgz exampleimagerepo``
|
|
|
|
Import from a local file
|
|
........................
|
|
|
|
Import to docker via pipe and standard in
|
|
|
|
``$ cat exampleimage.tgz | sudo 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.
|