mirror of https://github.com/docker/docs.git
49 lines
1.6 KiB
YAML
49 lines
1.6 KiB
YAML
command: docker plugin install
|
|
short: Install a plugin
|
|
long: |-
|
|
Installs and enables a plugin. Docker looks first for the plugin on your Docker
|
|
host. If the plugin does not exist locally, then the plugin is pulled from
|
|
the registry. Note that the minimum required registry version to distribute
|
|
plugins is 2.3.0
|
|
usage: docker plugin install [OPTIONS] PLUGIN [KEY=VALUE...]
|
|
pname: docker plugin
|
|
plink: docker_plugin.yaml
|
|
options:
|
|
- option: alias
|
|
description: Local name for plugin
|
|
- option: disable
|
|
default_value: "false"
|
|
description: Do not enable the plugin on install
|
|
- option: disable-content-trust
|
|
default_value: "true"
|
|
description: Skip image verification
|
|
- option: grant-all-permissions
|
|
default_value: "false"
|
|
description: Grant all permissions necessary to run the plugin
|
|
examples: |-
|
|
The following example installs `vieus/sshfs` plugin and [sets](plugin_set.md) its
|
|
`DEBUG` environment variable to `1`. To install, `pull` the plugin from Docker
|
|
Hub and prompt the user to accept the list of privileges that the plugin needs,
|
|
set the plugin's parameters and enable the plugin.
|
|
|
|
```bash
|
|
$ 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
|
|
```
|
|
|
|
After the plugin is installed, it appears in the list of plugins:
|
|
|
|
```bash
|
|
$ docker plugin ls
|
|
|
|
ID NAME TAG DESCRIPTION ENABLED
|
|
69553ca1d123 vieux/sshfs latest sshFS plugin for Docker true
|
|
```
|
|
|