github.com/pwn-term/docker@v0.0.0-20210616085119-6e977cce2565/cli/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  # plugin install
     8  
     9  ```markdown
    10  Usage:  docker plugin install [OPTIONS] PLUGIN [KEY=VALUE...]
    11  
    12  Install a plugin
    13  
    14  Options:
    15        --alias string            Local name for plugin
    16        --disable                 Do not enable the plugin on install
    17        --disable-content-trust   Skip image verification (default true)
    18        --grant-all-permissions   Grant all permissions necessary to run the plugin
    19        --help                    Print usage
    20  ```
    21  
    22  ## Description
    23  
    24  Installs and enables a plugin. Docker looks first for the plugin on your Docker
    25  host. If the plugin does not exist locally, then the plugin is pulled from
    26  the registry. Note that the minimum required registry version to distribute
    27  plugins is 2.3.0
    28  
    29  ## Examples
    30  
    31  The following example installs `vieus/sshfs` plugin and [sets](plugin_set.md) its
    32  `DEBUG` environment variable to `1`. To install, `pull` the plugin from Docker
    33  Hub and prompt the user to accept the list of privileges that the plugin needs,
    34  set the plugin's parameters and enable the plugin.
    35  
    36  ```bash
    37  $ docker plugin install vieux/sshfs DEBUG=1
    38  
    39  Plugin "vieux/sshfs" is requesting the following privileges:
    40   - network: [host]
    41   - device: [/dev/fuse]
    42   - capabilities: [CAP_SYS_ADMIN]
    43  Do you grant the above permissions? [y/N] y
    44  vieux/sshfs
    45  ```
    46  
    47  After the plugin is installed, it appears in the list of plugins:
    48  
    49  ```bash
    50  $ docker plugin ls
    51  
    52  ID             NAME                  DESCRIPTION                ENABLED
    53  69553ca1d123   vieux/sshfs:latest    sshFS plugin for Docker    true
    54  ```
    55  
    56  ## Related commands
    57  
    58  * [plugin create](plugin_create.md)
    59  * [plugin disable](plugin_disable.md)
    60  * [plugin enable](plugin_enable.md)
    61  * [plugin inspect](plugin_inspect.md)
    62  * [plugin ls](plugin_ls.md)
    63  * [plugin push](plugin_push.md)
    64  * [plugin rm](plugin_rm.md)
    65  * [plugin set](plugin_set.md)
    66  * [plugin upgrade](plugin_upgrade.md)