--- title: "plugin upgrade" description: "the plugin upgrade command description and usage" keywords: "plugin, upgrade" --- # plugin upgrade ```markdown Usage: docker plugin upgrade [OPTIONS] PLUGIN [REMOTE] Upgrade a plugin Options: --disable-content-trust Skip image verification (default true) --grant-all-permissions Grant all permissions necessary to run the plugin --help Print usage --skip-remote-check Do not check if specified remote plugin matches existing plugin image ``` ## Description Upgrades an existing plugin to the specified remote plugin image. If no remote is specified, Docker will re-pull the current image and use the updated version. All existing references to the plugin will continue to work. The plugin must be disabled before running the upgrade. ## Examples The following example installs `vieus/sshfs` plugin, uses it to create and use a volume, then upgrades the plugin. ```console $ docker plugin install vieux/sshfs DEBUG=1 Plugin "vieux/sshfs:next" is requesting the following privileges: - network: [host] - device: [/dev/fuse] - capabilities: [CAP_SYS_ADMIN] Do you grant the above permissions? [y/N] y vieux/sshfs:next $ docker volume create -d vieux/sshfs:next -o sshcmd=root@1.2.3.4:/tmp/shared -o password=XXX sshvolume sshvolume $ docker run -it -v sshvolume:/data alpine sh -c "touch /data/hello" $ docker plugin disable -f vieux/sshfs:next viex/sshfs:next # Here docker volume ls doesn't show 'sshfsvolume', since the plugin is disabled $ docker volume ls DRIVER VOLUME NAME $ docker plugin upgrade vieux/sshfs:next vieux/sshfs:next Plugin "vieux/sshfs:next" is requesting the following privileges: - network: [host] - device: [/dev/fuse] - capabilities: [CAP_SYS_ADMIN] Do you grant the above permissions? [y/N] y Upgrade plugin vieux/sshfs:next to vieux/sshfs:next $ docker plugin enable vieux/sshfs:next viex/sshfs:next $ docker volume ls DRIVER VOLUME NAME viuex/sshfs:next sshvolume $ docker run -it -v sshvolume:/data alpine sh -c "ls /data" hello ``` ## Related commands * [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 rm](plugin_rm.md) * [plugin set](plugin_set.md)