mirror of
https://github.com/docker/cli.git
synced 2025-08-18 18:22:03 +03:00
02677bc06e
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>
57 lines
1.6 KiB
Markdown
57 lines
1.6 KiB
Markdown
---
|
|
title: "plugin rm"
|
|
description: "the plugin rm command description and usage"
|
|
keywords: "plugin, rm"
|
|
---
|
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
repository at https://github.com/docker/docker/. Make all
|
|
pull requests against that repo. If you see this file in
|
|
another repository, consider it read-only there, as it will
|
|
periodically be overwritten by the definitive file. Pull
|
|
requests which include edits to this file in other repositories
|
|
will be rejected.
|
|
-->
|
|
|
|
# plugin rm
|
|
|
|
```markdown
|
|
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`](plugin_disable.md) 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;
|
|
|
|
```bash
|
|
$ docker plugin disable tiborvass/sample-volume-plugin
|
|
tiborvass/sample-volume-plugin
|
|
|
|
$ docker plugin rm tiborvass/sample-volume-plugin:latest
|
|
tiborvass/sample-volume-plugin
|
|
```
|
|
|
|
## Related information
|
|
|
|
* [plugin create](plugin_create.md)
|
|
* [plugin disable](plugin_disable.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 set](plugin_set.md)
|
|
* [plugin upgrade](plugin_upgrade.md)
|