docker plugin disable
Description🔗
Disable a plugin
API 1.25+
The client and daemon API must both be at least
1.25
to use this command. Use the docker version
command on the client to check
your client and daemon API versions.
Usage🔗
$ docker plugin disable [OPTIONS] PLUGIN
Extended description🔗
Disables a plugin. The plugin must be installed before it can be disabled,
see docker plugin install
. Without the -f
option,
a plugin that has references (e.g., volumes, networks) cannot be disabled.
For example uses of this command, refer to the examples section below.
Options🔗
Name, shorthand | Default | Description |
--force , -f |
Force the disable of an active plugin |
Examples🔗
The following example shows that the sample-volume-plugin
plugin is installed
and enabled:
$ 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:
$ 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
Parent command🔗
Command | Description |
---|---|
docker plugin | Manage plugins |
Related commands🔗
Command | Description |
docker plugin create | Create a plugin from a rootfs and configuration. Plugin data directory must contain config.json and rootfs directory. |
docker plugin disable | Disable a plugin |
docker plugin enable | Enable a plugin |
docker plugin inspect | Display detailed information on one or more plugins |
docker plugin install | Install a plugin |
docker plugin ls | List plugins |
docker plugin push | Push a plugin to a registry |
docker plugin rm | Remove one or more plugins |
docker plugin set | Change settings for a plugin |
docker plugin upgrade | Upgrade an existing plugin |