docker plugin rm
Description
Remove one or more plugins
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 rm [OPTIONS] PLUGIN [PLUGIN...]
Extended description
Removes a plugin. You cannot remove a plugin if it is enabled, you must disable
a plugin using the docker plugin disable before removing
it (or use --force, use of force is not recommended, since it can affect
functioning of running containers using the plugin).
For example uses of this command, refer to the examples section below.
Options
| Name, shorthand | Default | Description |
--force , -f |
Force the removal of an active plugin |
Examples
The following example disables and removes the sample-volume-plugin:latest
plugin:
$ docker plugin disable tiborvass/sample-volume-plugin
tiborvass/sample-volume-plugin
$ docker plugin rm tiborvass/sample-volume-plugin:latest
tiborvass/sample-volume-plugin
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 |