# docker image load

**Descripción:** Carga una imagen desde un archivo tar o desde STDIN

**Uso:** `docker image load [OPTIONS]`

**Alias:** `docker load`








## Descripción

Carga una imagen o un repositorio desde un archivo tar (incluso si está comprimido con gzip,
bzip2, xz o zstd) a partir de un archivo o STDIN. Restaura tanto las imágenes como las etiquetas.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-i`, `--input` |  |  Lee desde un archivo tar en lugar de STDIN |

 | `--platform` |  | API 1.48+ Carga únicamente la(s) plataforma(s) indicada(s). Formateado como una lista separada por comas de `os[/arch[/variant]]` (por ejemplo, `linux/amd64,linux/arm64/v8`).<br> |

 | `-q`, `--quiet` |  |  Suprime la salida de la carga |




## Ejemplos

```console
$ docker image ls

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
```

### Cargar imágenes desde 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
```

### Cargar imágenes desde un archivo (--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
```

### Cargar una plataforma específica (--platform) {#platform}

La opción `--platform` te permite especificar qué variante de plataforma de la
imagen deseas cargar. Por defecto, `docker load` carga todas las variantes de plataforma
que están presentes en el archivo. Utiliza la opción `--platform` para especificar qué
variante de plataforma de la imagen cargar. Se produce un error si la plataforma
indicada no está presente en el archivo.

La opción de plataforma toma el formato `os[/arch[/variant]]`; por ejemplo,
`linux/amd64` o `linux/arm64/v8`. La arquitectura y la variante son opcionales
y, si se omiten, toman como valor predeterminado la arquitectura nativa del demonio.

El siguiente ejemplo carga la variante `linux/amd64` de una imagen `alpine`
desde un archivo que contiene múltiples variantes de plataforma.

```console
$ docker image load -i image.tar --platform=linux/amd64
Loaded image: alpine:latest
```

El siguiente ejemplo intenta cargar una imagen `linux/ppc64le` de un
archivo, pero la plataforma dada no está presente en el archivo:

```console
$ docker image load -i image.tar --platform=linux/ppc64le
requested platform (linux/ppc64le) not found: image might be filtered out
```