github.com/kelda-inc/moby@v1.13.1/docs/reference/commandline/plugin_upgrade.md (about) 1 --- 2 title: "plugin upgrade" 3 description: "the plugin upgrade command description and usage" 4 keywords: "plugin, upgrade" 5 --- 6 7 <!-- This file is maintained within the docker/docker Github 8 repository at https://github.com/docker/docker/. Make all 9 pull requests against that repo. If you see this file in 10 another repository, consider it read-only there, as it will 11 periodically be overwritten by the definitive file. Pull 12 requests which include edits to this file in other repositories 13 will be rejected. 14 --> 15 16 # plugin upgrade 17 18 ```markdown 19 Usage: docker plugin upgrade [OPTIONS] PLUGIN [REMOTE] 20 21 Upgrade a plugin 22 23 Options: 24 --disable-content-trust Skip image verification (default true) 25 --grant-all-permissions Grant all permissions necessary to run the plugin 26 --help Print usage 27 --skip-remote-check Do not check if specified remote plugin matches existing plugin image 28 ``` 29 30 Upgrades an existing plugin to the specified remote plugin image. If no remote 31 is specified, Docker will re-pull the current image and use the updated version. 32 All existing references to the plugin will continue to work. 33 The plugin must be disabled before running the upgrade. 34 35 The following example installs `vieus/sshfs` plugin, uses it to create and use 36 a volume, then upgrades the plugin. 37 38 ```bash 39 $ docker plugin install vieux/sshfs DEBUG=1 40 41 Plugin "vieux/sshfs:next" is requesting the following privileges: 42 - network: [host] 43 - device: [/dev/fuse] 44 - capabilities: [CAP_SYS_ADMIN] 45 Do you grant the above permissions? [y/N] y 46 vieux/sshfs:next 47 48 $ docker volume create -d vieux/sshfs:next -o sshcmd=root@1.2.3.4:/tmp/shared -o password=XXX sshvolume 49 sshvolume 50 $ docker run -it -v sshvolume:/data alpine sh -c "touch /data/hello" 51 $ docker plugin disable -f vieux/sshfs:next 52 viex/sshfs:next 53 54 # Here docker volume ls doesn't show 'sshfsvolume', since the plugin is disabled 55 $ docker volume ls 56 DRIVER VOLUME NAME 57 58 $ docker plugin upgrade vieux/sshfs:next vieux/sshfs:next 59 Plugin "vieux/sshfs:next" is requesting the following privileges: 60 - network: [host] 61 - device: [/dev/fuse] 62 - capabilities: [CAP_SYS_ADMIN] 63 Do you grant the above permissions? [y/N] y 64 Upgrade plugin vieux/sshfs:next to vieux/sshfs:next 65 $ docker plugin enable vieux/sshfs:next 66 viex/sshfs:next 67 $ docker volume ls 68 DRIVER VOLUME NAME 69 viuex/sshfs:next sshvolume 70 $ docker run -it -v sshvolume:/data alpine sh -c "ls /data" 71 hello 72 ``` 73 74 ## Related information 75 76 * [plugin create](plugin_create.md) 77 * [plugin disable](plugin_disable.md) 78 * [plugin enable](plugin_enable.md) 79 * [plugin inspect](plugin_inspect.md) 80 * [plugin install](plugin_install.md) 81 * [plugin ls](plugin_ls.md) 82 * [plugin push](plugin_push.md) 83 * [plugin rm](plugin_rm.md) 84 * [plugin set](plugin_set.md)