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)