1
0
mirror of https://github.com/docker/cli.git synced 2025-08-17 07:21:07 +03:00
Files
cli/docs/reference/commandline/plugin_rm.md
Brian Goff 02677bc06e 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-06-02 00:10:52 +00:00

1.6 KiB

title, description, keywords
title description keywords
plugin rm the plugin rm command description and usage plugin, rm

plugin rm

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

Remove one or more plugins

Aliases:
  rm, remove

Options:
      -f, --force  Force the removal of an active plugin
          --help   Print usage

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

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