| # plugin disable | |
| <!---MARKER_GEN_START--> | |
| Disable a plugin | |
| ### Options | |
| | Name | Type | Default | Description | | |
| |:----------------|:-------|:--------|:--------------------------------------| | |
| | `-f`, `--force` | `bool` | | Force the disable of an active plugin | | |
| <!---MARKER_GEN_END--> | |
| ## Description | |
| Disables a plugin. The plugin must be installed before it can be disabled, | |
| see [`docker plugin install`](plugin_install.md). Without the `-f` option, | |
| a plugin that has references (e.g., volumes, networks) cannot be disabled. | |
| ## Examples | |
| The following example shows that the `sample-volume-plugin` plugin is installed | |
| and enabled: | |
| ```console | |
| $ docker plugin ls | |
| ID NAME DESCRIPTION ENABLED | |
| 69553ca1d123 tiborvass/sample-volume-plugin:latest A test plugin for Docker true | |
| ``` | |
| To disable the plugin, use the following command: | |
| ```console | |
| $ docker plugin disable 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 false | |
| ``` | |
| ## Related commands | |
| * [plugin create](plugin_create.md) | |
| * [plugin enable](plugin_enable.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) |