docker plugin rm

Estimated reading time: 2 minutes

Edge only: This is the CLI reference for Docker CE Edge versions. Some of these options may not be available to Docker CE stable or Docker EE. You can view the stable version of this CLI reference or learn about Docker CE Edge.

Description

Remove one or more plugins

Usage

docker plugin rm [OPTIONS] PLUGIN [PLUGIN...]

Options

Name, shorthand Default Description
--force, -f false Force the removal of an active plugin

Parent command

Command Description
docker plugin Manage plugins
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

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).

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