mirror of https://github.com/docker/docs.git
127 lines
4.0 KiB
YAML
127 lines
4.0 KiB
YAML
command: docker image load
|
|
aliases: docker image load, docker load
|
|
short: Load an image from a tar archive or STDIN
|
|
long: |-
|
|
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.
|
|
usage: docker image load [OPTIONS]
|
|
pname: docker image
|
|
plink: docker_image.yaml
|
|
options:
|
|
- option: input
|
|
shorthand: i
|
|
value_type: string
|
|
description: Read from tar archive file, instead of STDIN
|
|
details_url: '#input'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: platform
|
|
value_type: string
|
|
description: |
|
|
Load only the given platform variant. Formatted as `os[/arch[/variant]]` (e.g., `linux/amd64`)
|
|
details_url: '#platform'
|
|
deprecated: false
|
|
hidden: false
|
|
min_api_version: "1.48"
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: quiet
|
|
shorthand: q
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Suppress the load output
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
inherited_options:
|
|
- option: help
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Print usage
|
|
deprecated: false
|
|
hidden: true
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
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
|
|
```
|
|
|
|
### Load images from a file (--input) {#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
|
|
```
|
|
|
|
|
|
### Load a specific platform (--platform) {#platform}
|
|
|
|
The `--platform` option allows you to specify which platform variant of the
|
|
image to load. By default, `docker load` loads all platform variants that
|
|
are present in the archive. Use the `--platform` option to specify which
|
|
platform variant of the image to load. An error is produced if the given
|
|
platform is not present in the archive.
|
|
|
|
The platform option takes the `os[/arch[/variant]]` format; for example,
|
|
`linux/amd64` or `linux/arm64/v8`. Architecture and variant are optional,
|
|
and default to the daemon's native architecture if omitted.
|
|
|
|
The following example loads the `linux/amd64` variant of an `alpine` image
|
|
from an archive that contains multiple platform variants.
|
|
|
|
```console
|
|
$ docker image load -i image.tar --platform=linux/amd64
|
|
Loaded image: alpine:latest
|
|
```
|
|
|
|
The following example attempts to load a `linux/ppc64le` image from an
|
|
archive, but the given platform is not present in the archive;
|
|
|
|
```console
|
|
$ docker image load -i image.tar --platform=linux/ppc64le
|
|
requested platform (linux/ppc64le) not found: image might be filtered out
|
|
```
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|