1# load
2
3<!---MARKER_GEN_START-->
4Load an image from a tar archive or STDIN
5
6### Aliases
7
8`docker image load`, `docker load`
9
10### Options
11
12| Name | Type | Default | Description |
13|:------------------------------------|:---------|:--------|:---------------------------------------------|
14| [`-i`](#input), [`--input`](#input) | `string` | | Read from tar archive file, instead of STDIN |
15| `-q`, `--quiet` | | | Suppress the load output |
16
17
18<!---MARKER_GEN_END-->
19
20## Description
21
22Load an image or repository from a tar archive (even if compressed with gzip,
23bzip2, xz or zstd) from a file or STDIN. It restores both images and tags.
24
25## Examples
26
27```console
28$ docker image ls
29
30REPOSITORY TAG IMAGE ID CREATED SIZE
31```
32
33### Load images from STDIN
34
35```console
36$ docker load < busybox.tar.gz
37
38Loaded image: busybox:latest
39$ docker images
40REPOSITORY TAG IMAGE ID CREATED SIZE
41busybox latest 769b9341d937 7 weeks ago 2.489 MB
42```
43
44### <a name="input"></a> Load images from a file (--input)
45
46```console
47$ docker load --input fedora.tar
48
49Loaded image: fedora:rawhide
50Loaded image: fedora:20
51
52$ docker images
53
54REPOSITORY TAG IMAGE ID CREATED SIZE
55busybox latest 769b9341d937 7 weeks ago 2.489 MB
56fedora rawhide 0d20aec6529d 7 weeks ago 387 MB
57fedora 20 58394af37342 7 weeks ago 385.5 MB
58fedora heisenbug 58394af37342 7 weeks ago 385.5 MB
59fedora latest 58394af37342 7 weeks ago 385.5 MB
60```
View as plain text