DockerCLI/docs/reference/commandline/plugin_install.md

1.5 KiB

plugin install (experimental)

Usage:  docker plugin install PLUGIN [OPTIONS]

Install a plugin

Options:
      --disable                 do not enable the plugin on install
      --grant-all-permissions   grant all permissions necessary to run the plugin
      --help                    Print usage

Installs and enables a plugin. Docker looks first for the plugin on your Docker host. If the plugin does not exist locally, then the plugin is pulled from Docker Hub.

The following example installs no-remove plugin. Install consists of pulling the plugin from Docker Hub, prompting the user to accept the list of privileges that the plugin needs and enabling the plugin.

$ docker plugin install tiborvass/no-remove
Plugin "tiborvass/no-remove:latest" requested the following privileges:
 - Networking: host
 - Mounting host path: /data
Do you grant the above permissions? [y/N] y

After the plugin is installed, it appears in the list of plugins:

$ docker plugin ls
NAME                	VERSION             ACTIVE
tiborvass/no-remove   latest              true