github.com/brahmaroutu/docker@v1.2.1-0.20160809185609-eb28dde01f16/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  Docker Hub.
    28  
    29  
    30  The following example installs `no-remove` plugin. Install consists of pulling the
    31  plugin from Docker Hub, prompting the user to accept the list of privileges that
    32  the plugin needs and enabling the plugin.
    33  
    34  ```bash
    35  $ docker plugin install tiborvass/no-remove
    36  
    37  Plugin "tiborvass/no-remove" is requesting the following privileges:
    38   - network: [host]
    39   - mount: [/data]
    40   - device: [/dev/cpu_dma_latency]
    41  Do you grant the above permissions? [y/N] y
    42  tiborvass/no-remove
    43  ```
    44  
    45  After the plugin is installed, it appears in the list of plugins:
    46  
    47  ```bash
    48  $ docker plugin ls
    49  
    50  NAME                  VERSION             ACTIVE
    51  tiborvass/no-remove   latest              true
    52  ```
    53  
    54  ## Related information
    55  
    56  * [plugin ls](plugin_ls.md)
    57  * [plugin enable](plugin_enable.md)
    58  * [plugin disable](plugin_disable.md)
    59  * [plugin inspect](plugin_inspect.md)
    60  * [plugin rm](plugin_rm.md)