1---
2layout: "docs"
3page_title: "plugin register - Command"
4sidebar_title: "<code>register</code>"
5sidebar_current: "docs-commands-plugin-register"
6description: |-
7  The "plugin register" command registers a new plugin in Vault's plugin
8  catalog.
9---
10
11# plugin register
12
13The `plugin register` command registers a new plugin in Vault's plugin catalog.
14The plugin's type of "auth", "database", or "secret" must be included.
15
16## Examples
17
18Register a plugin:
19
20```text
21$ vault plugin register \
22    -sha256=d3f0a8be02f6c074cf38c9c99d4d04c9c6466249 \
23    auth my-custom-plugin
24Success! Registered plugin: my-custom-plugin
25```
26
27Register a plugin with custom args:
28
29```text
30$ vault plugin register \
31    -sha256=d3f0a8be02f6c074cf38c9c99d4d04c9c6466249 \
32    -args=--with-glibc,--with-curl-bindings \
33    auth my-custom-plugin
34```
35
36## Usage
37
38The following flags are available in addition to the [standard set of
39flags](/docs/commands/index.html) included on all commands.
40
41### Output Options
42
43- `-format` `(string: "table")` - Print the output in the given format. Valid
44  formats are "table", "json", or "yaml". This can also be specified via the
45  `VAULT_FORMAT` environment variable.
46
47### Command Options
48
49- `-sha256` `(string: <required>)` - Checksum (SHA256) of the plugin binary.
50
51- `-args` `(string: "")` - List of arguments to pass to the binary plugin during
52  each invocation. Specify multiple arguments with commas.
53
54- `-command` `(string: "")` - Name of the command to run to invoke the binary.
55  By default, this is the name of the plugin.
56