github.com/flavio/docker@v0.1.3-0.20170117145210-f63d1a6eec47/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  ---
     6  
     7  <!-- This file is maintained within the docker/docker Github
     8       repository at https://github.com/docker/docker/. Make all
     9       pull requests against that repo. If you see this file in
    10       another repository, consider it read-only there, as it will
    11       periodically be overwritten by the definitive file. Pull
    12       requests which include edits to this file in other repositories
    13       will be rejected.
    14  -->
    15  
    16  # plugin install
    17  
    18  ```markdown
    19  Usage:  docker plugin install [OPTIONS] PLUGIN [KEY=VALUE...]
    20  
    21  Install a plugin
    22  
    23  Options:
    24        --alias string            Local name for plugin
    25        --disable                 Do not enable the plugin on install
    26        --disable-content-trust   Skip image verification (default true)
    27        --grant-all-permissions   Grant all permissions necessary to run the plugin
    28        --help                    Print usage
    29  ```
    30  
    31  Installs and enables a plugin. Docker looks first for the plugin on your Docker
    32  host. If the plugin does not exist locally, then the plugin is pulled from
    33  the registry. Note that the minimum required registry version to distribute
    34  plugins is 2.3.0
    35  
    36  
    37  The following example installs `vieus/sshfs` plugin and [set](plugin_set.md) it's env variable
    38  `DEBUG` to 1. Install consists of pulling the plugin from Docker Hub, prompting
    39  the user to accept the list of privileges that the plugin needs, settings parameters
    40   and enabling the plugin.
    41  
    42  ```bash
    43  $ docker plugin install vieux/sshfs DEBUG=1
    44  
    45  Plugin "vieux/sshfs" is requesting the following privileges:
    46   - network: [host]
    47   - device: [/dev/fuse]
    48   - capabilities: [CAP_SYS_ADMIN]
    49  Do you grant the above permissions? [y/N] y
    50  vieux/sshfs
    51  ```
    52  
    53  After the plugin is installed, it appears in the list of plugins:
    54  
    55  ```bash
    56  $ docker plugin ls
    57  
    58  ID                  NAME                  TAG                 DESCRIPTION                ENABLED
    59  69553ca1d123        vieux/sshfs           latest              sshFS plugin for Docker    true
    60  ```
    61  
    62  ## Related information
    63  
    64  * [plugin create](plugin_create.md)
    65  * [plugin disable](plugin_disable.md)
    66  * [plugin enable](plugin_enable.md)
    67  * [plugin inspect](plugin_inspect.md)
    68  * [plugin ls](plugin_ls.md)
    69  * [plugin push](plugin_push.md)
    70  * [plugin rm](plugin_rm.md)
    71  * [plugin set](plugin_set.md)