mirror of https://github.com/docker/cli.git
61 lines
1.9 KiB
Markdown
61 lines
1.9 KiB
Markdown
# load
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Load an image from a tar archive or STDIN
|
|
|
|
### Aliases
|
|
|
|
`docker image load`, `docker load`
|
|
|
|
### Options
|
|
|
|
| Name | Type | Default | Description |
|
|
|:------------------------------------|:---------|:--------|:---------------------------------------------|
|
|
| [`-i`](#input), [`--input`](#input) | `string` | | Read from tar archive file, instead of STDIN |
|
|
| `-q`, `--quiet` | `bool` | | Suppress the load output |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|
|
## Description
|
|
|
|
Load an image or repository from a tar archive (even if compressed with gzip,
|
|
bzip2, xz or zstd) from a file or STDIN. It restores both images and tags.
|
|
|
|
## Examples
|
|
|
|
```console
|
|
$ docker image ls
|
|
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE
|
|
```
|
|
|
|
### Load images from STDIN
|
|
|
|
```console
|
|
$ docker load < busybox.tar.gz
|
|
|
|
Loaded image: busybox:latest
|
|
$ docker images
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE
|
|
busybox latest 769b9341d937 7 weeks ago 2.489 MB
|
|
```
|
|
|
|
### <a name="input"></a> Load images from a file (--input)
|
|
|
|
```console
|
|
$ docker load --input fedora.tar
|
|
|
|
Loaded image: fedora:rawhide
|
|
Loaded image: fedora:20
|
|
|
|
$ docker images
|
|
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE
|
|
busybox latest 769b9341d937 7 weeks ago 2.489 MB
|
|
fedora rawhide 0d20aec6529d 7 weeks ago 387 MB
|
|
fedora 20 58394af37342 7 weeks ago 385.5 MB
|
|
fedora heisenbug 58394af37342 7 weeks ago 385.5 MB
|
|
fedora latest 58394af37342 7 weeks ago 385.5 MB
|
|
```
|