# docker plugin install

**Descripción:** Instala un plugin

**Uso:** `docker plugin install [OPTIONS] PLUGIN [KEY=VALUE...]`










## Descripción

Instala y habilita un plugin. Docker busca primero el plugin en tu host
de Docker. Si el plugin no existe localmente, se descarga desde
el registro. Ten en cuenta que la versión mínima requerida del registro para distribuir
plugins es la 2.3.0.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--alias` |  |  Nombre local para el plugin |

 | `--disable` |  |  No habilitar el plugin al instalarlo |

 | `--grant-all-permissions` |  |  Conceder todos los permisos necesarios para ejecutar el plugin |




## Ejemplos

El siguiente ejemplo instala el plugin `vieux/sshfs` y [establece](/reference/cli/docker/plugin/set/) su
variable de entorno `DEBUG` en `1`. Para instalarlo, descarga el plugin desde Docker
Hub, solicita al usuario que acepte la lista de privilegios que necesita el plugin,
configura sus parámetros y lo habilita.

```console
$ docker plugin install vieux/sshfs DEBUG=1

Plugin "vieux/sshfs" is requesting the following privileges:
 - network: [host]
 - device: [/dev/fuse]
 - capabilities: [CAP_SYS_ADMIN]
Do you grant the above permissions? [y/N] y
vieux/sshfs
```

Una vez instalado el plugin, este aparece en la lista de plugins:

```console
$ docker plugin ls

ID             NAME                  DESCRIPTION                ENABLED
69553ca1d123   vieux/sshfs:latest    sshFS plugin for Docker    true
```