2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "load"
|
|
|
|
description: "The load command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "stdin, tarred, repository"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
|
|
# load
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
|
|
|
Usage: docker load [OPTIONS]
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2018-01-05 16:49:16 -05:00
|
|
|
Load an image or repository from a tar archive (even if compressed with gzip,
|
|
|
|
bzip2, or xz) from a file or STDIN.
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Options:
|
|
|
|
--help Print usage
|
|
|
|
-i, --input string Read from tar archive file, instead of STDIN.
|
|
|
|
The tarball may be compressed with gzip, bzip, or xz
|
|
|
|
-q, --quiet Suppress the load output but still outputs the imported images
|
|
|
|
```
|
2021-08-21 08:54:14 -04:00
|
|
|
|
2017-01-27 19:47:41 -05:00
|
|
|
## Description
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2018-01-05 16:49:16 -05:00
|
|
|
Load an image or repository from a tar archive (even if compressed with gzip,
|
|
|
|
bzip2, or xz) from a file or STDIN. It restores both images and tags.
|
2017-02-07 18:42:48 -05:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
2021-08-21 08:54:14 -04:00
|
|
|
```console
|
2018-04-16 10:01:53 -04:00
|
|
|
$ docker image ls
|
2017-02-07 18:42:48 -05:00
|
|
|
|
|
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE
|
2022-03-30 09:05:29 -04:00
|
|
|
```
|
|
|
|
|
|
|
|
### Load images from STDIN
|
2017-02-07 18:42:48 -05:00
|
|
|
|
2022-03-30 09:05:29 -04:00
|
|
|
```console
|
2017-02-07 18:42:48 -05:00
|
|
|
$ 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
|
2022-03-30 09:05:29 -04:00
|
|
|
```
|
2017-02-07 18:42:48 -05:00
|
|
|
|
2022-03-30 09:05:29 -04:00
|
|
|
### <a name=input></a> Load images from a file (--input)
|
|
|
|
|
|
|
|
```console
|
2017-02-07 18:42:48 -05:00
|
|
|
$ 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
|
|
|
|
```
|