github.com/vieux/docker@v0.6.3-0.20161004191708-e097c2a938c7/docs/reference/commandline/plugin_install.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "plugin install"
     4  description = "the plugin install command description and usage"
     5  keywords = ["plugin, install"]
     6  advisory = "experimental"
     7  [menu.main]
     8  parent = "smn_cli"
     9  +++
    10  <![end-metadata]-->
    11  
    12  # plugin install (experimental)
    13  
    14  ```markdown
    15  Usage:  docker plugin install [OPTIONS] PLUGIN
    16  
    17  Install a plugin
    18  
    19  Options:
    20        --disable                 Do not enable the plugin on install
    21        --grant-all-permissions   Grant all permissions necessary to run the plugin
    22        --help                    Print usage
    23  ```
    24  
    25  Installs and enables a plugin. Docker looks first for the plugin on your Docker
    26  host. If the plugin does not exist locally, then the plugin is pulled from
    27  the registry. Note that the minimum required registry version to distribute
    28  plugins is 2.3.0
    29  
    30  
    31  The following example installs `no-remove` plugin. Install consists of pulling the
    32  plugin from Docker Hub, prompting the user to accept the list of privileges that
    33  the plugin needs and enabling the plugin.
    34  
    35  ```bash
    36  $ docker plugin install tiborvass/no-remove
    37  
    38  Plugin "tiborvass/no-remove" is requesting the following privileges:
    39   - network: [host]
    40   - mount: [/data]
    41   - device: [/dev/cpu_dma_latency]
    42  Do you grant the above permissions? [y/N] y
    43  tiborvass/no-remove
    44  ```
    45  
    46  After the plugin is installed, it appears in the list of plugins:
    47  
    48  ```bash
    49  $ docker plugin ls
    50  
    51  NAME                  TAG                 DESCRIPTION                ENABLED
    52  tiborvass/no-remove   latest              A test plugin for Docker   true
    53  ```
    54  
    55  ## Related information
    56  
    57  * [plugin ls](plugin_ls.md)
    58  * [plugin enable](plugin_enable.md)
    59  * [plugin disable](plugin_disable.md)
    60  * [plugin inspect](plugin_inspect.md)
    61  * [plugin rm](plugin_rm.md)