github.com/kim0/docker@v0.6.2-0.20161130212042-4addda3f07e7/docs/reference/commandline/plugin_install.md (about) 1 --- 2 title: "plugin install" 3 description: "the plugin install command description and usage" 4 keywords: ["plugin, install"] 5 advisory: "experimental" 6 --- 7 8 <!-- This file is maintained within the docker/docker Github 9 repository at https://github.com/docker/docker/. Make all 10 pull requests against that repo. If you see this file in 11 another repository, consider it read-only there, as it will 12 periodically be overwritten by the definitive file. Pull 13 requests which include edits to this file in other repositories 14 will be rejected. 15 --> 16 17 # plugin install (experimental) 18 19 ```markdown 20 Usage: docker plugin install [OPTIONS] PLUGIN 21 22 Install a plugin 23 24 Options: 25 --disable Do not enable the plugin on install 26 --grant-all-permissions Grant all permissions necessary to run the plugin 27 --help Print usage 28 ``` 29 30 Installs and enables a plugin. Docker looks first for the plugin on your Docker 31 host. If the plugin does not exist locally, then the plugin is pulled from 32 the registry. Note that the minimum required registry version to distribute 33 plugins is 2.3.0 34 35 36 The following example installs `no-remove` plugin. Install consists of pulling the 37 plugin from Docker Hub, prompting the user to accept the list of privileges that 38 the plugin needs and enabling the plugin. 39 40 ```bash 41 $ docker plugin install tiborvass/no-remove 42 43 Plugin "tiborvass/no-remove" is requesting the following privileges: 44 - network: [host] 45 - mount: [/data] 46 - device: [/dev/cpu_dma_latency] 47 Do you grant the above permissions? [y/N] y 48 tiborvass/no-remove 49 ``` 50 51 After the plugin is installed, it appears in the list of plugins: 52 53 ```bash 54 $ docker plugin ls 55 56 NAME TAG DESCRIPTION ENABLED 57 tiborvass/no-remove latest A test plugin for Docker true 58 ``` 59 60 ## Related information 61 62 * [plugin ls](plugin_ls.md) 63 * [plugin enable](plugin_enable.md) 64 * [plugin disable](plugin_disable.md) 65 * [plugin inspect](plugin_inspect.md) 66 * [plugin rm](plugin_rm.md)