docker plugin create
Description
Create a plugin from a rootfs and configuration. Plugin data directory must contain config.json and rootfs directory.
API 1.25+
The client and daemon API must both be at least
1.25
to use this command. Use the docker version
command on the client to check
your client and daemon API versions.
Usage
$ docker plugin create [OPTIONS] PLUGIN PLUGIN-DATA-DIR
Extended description
Creates a plugin. Before creating the plugin, prepare the plugin’s root filesystem as well as the config.json
For example uses of this command, refer to the examples section below.
Options
Name, shorthand | Default | Description |
--compress |
Compress the context using gzip |
Examples
The following example shows how to create a sample plugin
.
$ ls -ls /home/pluginDir
total 4
4 -rw-r--r-- 1 root root 431 Nov 7 01:40 config.json
0 drwxr-xr-x 19 root root 420 Nov 7 01:40 rootfs
$ docker plugin create plugin /home/pluginDir
plugin
$ docker plugin ls
ID NAME DESCRIPTION ENABLED
672d8144ec02 plugin:latest A sample plugin for Docker false
The plugin can subsequently be enabled for local use or pushed to the public registry.
Parent command
Command | Description |
---|---|
docker plugin | Manage plugins |
Related commands
Command | Description |
docker plugin create | Create a plugin from a rootfs and configuration. Plugin data directory must contain config.json and rootfs directory. |
docker plugin disable | Disable a plugin |
docker plugin enable | Enable a plugin |
docker plugin inspect | Display detailed information on one or more plugins |
docker plugin install | Install a plugin |
docker plugin ls | List plugins |
docker plugin push | Push a plugin to a registry |
docker plugin rm | Remove one or more plugins |
docker plugin set | Change settings for a plugin |
docker plugin upgrade | Upgrade an existing plugin |