docker-cli/docs/reference/commandline/plugin_enable.md

# plugin enable

<!---MARKER_GEN_START-->
Enable a plugin

### Options

| Name        | Type  | Default | Description                      |
|:------------|:------|:--------|:---------------------------------|
| `--timeout` | `int` | `30`    | HTTP client timeout (in seconds) |


<!---MARKER_GEN_END-->

## Description

Enables a plugin. The plugin must be installed before it can be enabled,
see [`docker plugin install`](plugin_install.md).

## Examples

The following example shows that the `sample-volume-plugin` plugin is installed,
but disabled:

```console
$ docker plugin ls

ID            NAME                                    DESCRIPTION                ENABLED
69553ca1d123  tiborvass/sample-volume-plugin:latest   A test plugin for Docker   false
```

To enable the plugin, use the following command:

```console
$ docker plugin enable tiborvass/sample-volume-plugin

tiborvass/sample-volume-plugin

$ docker plugin ls

ID            NAME                                    DESCRIPTION                ENABLED
69553ca1d123  tiborvass/sample-volume-plugin:latest   A test plugin for Docker   true
```

## Related commands

* [plugin create](plugin_create.md)
* [plugin disable](plugin_disable.md)
* [plugin inspect](plugin_inspect.md)
* [plugin install](plugin_install.md)
* [plugin ls](plugin_ls.md)
* [plugin push](plugin_push.md)
* [plugin rm](plugin_rm.md)
* [plugin set](plugin_set.md)
* [plugin upgrade](plugin_upgrade.md)
move plugins out of experimental Signed-off-by: Victor Vieux <vieux@docker.com> 2016-11-09 17:49:09 -08:00			`# plugin enable`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 19:04:05 +01:00			`<!---MARKER_GEN_START-->`
Updates on cli reference documentation - Update ps with `--last` flag - Update commands with current output - Make sure hugo does not detect the wrong language - Update usage for `tag` command to be more coherent with the other ones Signed-off-by: Vincent Demeester <vincent@sbr.pm> 2016-07-07 20:43:18 +02:00			`Enable a plugin`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 19:04:05 +01:00			`### Options`

			`\| Name \| Type \| Default \| Description \|`
			`\|:------------\|:------\|:--------\|:---------------------------------\|`
			\| `--timeout` \| `int` \| `30` \| HTTP client timeout (in seconds) \|


			`<!---MARKER_GEN_END-->`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00			`## Description`

docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			`Enables a plugin. The plugin must be installed before it can be enabled,`
			see [`docker plugin install`](plugin_install.md).

Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00			`## Examples`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
replace no-remove by sample-volume-plugin in docs Signed-off-by: Victor Vieux <vieux@docker.com> 2016-12-14 00:35:34 -08:00			The following example shows that the `sample-volume-plugin` plugin is installed,
replace active by enabled for consistency in plugins Signed-off-by: Victor Vieux <vieux@docker.com> 2016-08-04 16:19:46 -07:00			`but disabled:`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
docs: use "console" code-hint for shell examples This replaces the use of bash where suitable, to allow easier copy/pasting of shell examples without copying the prompt or process output. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2021-08-21 14:54:14 +02:00			```console
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			`$ docker plugin ls`
docs: update reference docs for plugins the output/response slightly changed in 340964db1c8f161a2ad156023eb47dcc93bf804b, and `:latest` is no longer required for various actions. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-07-20 23:37:55 +02:00
docs: fix example output for docker plugin ls The output format was changed to combine tag and name in a single column, but this change was never reflected in the docs. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2020-06-18 16:37:36 +02:00			`ID NAME DESCRIPTION ENABLED`
			`69553ca1d123 tiborvass/sample-volume-plugin:latest A test plugin for Docker false`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			```
docs: update reference docs for plugins the output/response slightly changed in 340964db1c8f161a2ad156023eb47dcc93bf804b, and `:latest` is no longer required for various actions. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-07-20 23:37:55 +02:00
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			`To enable the plugin, use the following command:`

docs: use "console" code-hint for shell examples This replaces the use of bash where suitable, to allow easier copy/pasting of shell examples without copying the prompt or process output. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2021-08-21 14:54:14 +02:00			```console
replace no-remove by sample-volume-plugin in docs Signed-off-by: Victor Vieux <vieux@docker.com> 2016-12-14 00:35:34 -08:00			`$ docker plugin enable tiborvass/sample-volume-plugin`
docs: update reference docs for plugins the output/response slightly changed in 340964db1c8f161a2ad156023eb47dcc93bf804b, and `:latest` is no longer required for various actions. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-07-20 23:37:55 +02:00
replace no-remove by sample-volume-plugin in docs Signed-off-by: Victor Vieux <vieux@docker.com> 2016-12-14 00:35:34 -08:00			`tiborvass/sample-volume-plugin`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
			`$ docker plugin ls`
docs: update reference docs for plugins the output/response slightly changed in 340964db1c8f161a2ad156023eb47dcc93bf804b, and `:latest` is no longer required for various actions. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-07-20 23:37:55 +02:00
docs: fix example output for docker plugin ls The output format was changed to combine tag and name in a single column, but this change was never reflected in the docs. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2020-06-18 16:37:36 +02:00			`ID NAME DESCRIPTION ENABLED`
			`69553ca1d123 tiborvass/sample-volume-plugin:latest A test plugin for Docker true`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			```

Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 15:42:48 -08:00			`## Related commands`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00
Add plugin create functionality. Signed-off-by: Anusha Ragunathan <anusha@docker.com> 2016-10-04 12:01:19 -07:00			`* [plugin create](plugin_create.md)`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			`* [plugin disable](plugin_disable.md)`
			`* [plugin inspect](plugin_inspect.md)`
			`* [plugin install](plugin_install.md)`
Add docs for plugin push Signed-off-by: Anusha Ragunathan <anusha@docker.com> 2016-11-14 08:38:06 -08:00			`* [plugin ls](plugin_ls.md)`
			`* [plugin push](plugin_push.md)`
docker plugin commandline reference Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2016-06-09 23:57:15 +02:00			`* [plugin rm](plugin_rm.md)`
support env for docker plugin set Signed-off-by: Victor Vieux <vieux@docker.com> 2016-10-31 17:07:05 -07:00			`* [plugin set](plugin_set.md)`
Add docker plugin upgrade This allows a plugin to be upgraded without requiring to uninstall/reinstall a plugin. Since plugin resources (e.g. volumes) are tied to a plugin ID, this is important to ensure resources aren't lost. The plugin must be disabled while upgrading (errors out if enabled). This does not add any convenience flags for automatically disabling/re-enabling the plugin during before/after upgrade. Since an upgrade may change requested permissions, the user is required to accept permissions just like `docker plugin install`. Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2017-01-28 16:54:32 -08:00			`* [plugin upgrade](plugin_upgrade.md)`