mirror of https://github.com/docker/cli.git
52 lines
1.3 KiB
Markdown
52 lines
1.3 KiB
Markdown
|
<!--[metadata]>
|
||
|
+++
|
||
|
title = "plugin install"
|
||
|
description = "the plugin install command description and usage"
|
||
|
keywords = ["plugin, install"]
|
||
|
[menu.main]
|
||
|
parent = "smn_cli"
|
||
|
advisory = "experimental"
|
||
|
+++
|
||
|
<![end-metadata]-->
|
||
|
|
||
|
# plugin install (experimental)
|
||
|
|
||
|
Usage: docker plugin install PLUGIN
|
||
|
|
||
|
Install a plugin
|
||
|
|
||
|
--help Print usage
|
||
|
|
||
|
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
|
||
|
Docker Hub.
|
||
|
|
||
|
|
||
|
The following example installs `no-remove` plugin. Install consists of pulling the
|
||
|
plugin from Docker Hub, prompting the user to accept the list of privileges that
|
||
|
the plugin needs and enabling the plugin.
|
||
|
|
||
|
```bash
|
||
|
$ docker plugin install tiborvass/no-remove
|
||
|
Plugin "tiborvass/no-remove:latest" requested the following privileges:
|
||
|
- Networking: host
|
||
|
- Mounting host path: /data
|
||
|
Do you grant the above permissions? [y/N] y
|
||
|
```
|
||
|
|
||
|
After the plugin is installed, it appears in the list of plugins:
|
||
|
|
||
|
```bash
|
||
|
$ docker plugin ls
|
||
|
NAME VERSION ACTIVE
|
||
|
tiborvass/no-remove latest true
|
||
|
```
|
||
|
|
||
|
## Related information
|
||
|
|
||
|
* [plugin ls](plugin_ls.md)
|
||
|
* [plugin enable](plugin_enable.md)
|
||
|
* [plugin disable](plugin_disable.md)
|
||
|
* [plugin inspect](plugin_inspect.md)
|
||
|
* [plugin rm](plugin_rm.md)
|