| --- |
| title: "plugin push" |
| description: "the plugin push command description and usage" |
| keywords: "plugin, push" |
| --- |
| |
| <!-- This file is maintained within the docker/cli GitHub |
| repository at https://github.com/docker/cli/. 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. |
| --> |
| |
| ```markdown |
| Usage: docker plugin push [OPTIONS] PLUGIN[:TAG] |
| |
| Push a plugin to a registry |
| |
| Options: |
| --disable-content-trust Skip image signing (default true) |
| --help Print usage |
| ``` |
| |
| ## Description |
| |
| After you have created a plugin using `docker plugin create` and the plugin is |
| ready for distribution, use `docker plugin push` to share your images to Docker |
| Hub or a self-hosted registry. |
| |
| Registry credentials are managed by [docker login](login.md). |
| |
| ## Examples |
| |
| The following example shows how to push a sample `user/plugin`. |
| |
| ```bash |
| $ docker plugin ls |
| |
| ID NAME TAG DESCRIPTION ENABLED |
| 69553ca1d456 user/plugin latest A sample plugin for Docker false |
| |
| $ docker plugin push user/plugin |
| ``` |
| |
| ## 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 rm](plugin_rm.md) |
| * [plugin set](plugin_set.md) |
| * [plugin upgrade](plugin_upgrade.md) |