docker image load (original) (raw)
| Description | Load an image from a tar archive or STDIN |
|---|---|
| Usage | docker image load [OPTIONS] |
| AliasesAn alias is a short or memorable alternative for a longer command. | docker load |
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.
| Option | Default | Description |
|---|---|---|
| -i, --input | Read from tar archive file, instead of STDIN | |
| --platform | API 1.48+Load only the given platform variant. Formatted as os[/arch[/variant]] (e.g., linux/amd64) | |
| -q, --quiet | Suppress the load output |
Load images from STDIN
Load images from a file (--input)
Load a specific 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.
The following example attempts to load a linux/ppc64le image from an archive, but the given platform is not present in the archive;