> For the complete documentation index, see [llms.txt](https://docs.enclaive.cloud/virtual-hsm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enclaive.cloud/virtual-hsm/cli/configuration-and-management/vhsm-plugin/vhsm-plugin-info.md).

# vhsm plugin info

The `vhsm plugin info` command displays detailed information about a plugin in vHSM’s plugin catalog. You must specify the plugin type `auth`, `database`, or `secret` and the plugin name.

The output includes the deprecation\_status field for all built-in plugins, providing lifecycle visibility.

**Usage**

```bash
vhsm plugin info [options] <plugin-type> <plugin-name>
```

* `<plugin-type>`: Type of the plugin (e.g., `auth`, `database`, or `secret`)
* `<plugin-name>`: Name of the plugin in the catalog

**Available Flags**

**Command options**

| Flag                    | Description                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| `-plugin-version=<str>` | Semantic version of the plugin to query. If unspecified, vHSM defaults to the unversioned or built-in plugin. |

**Output options**

| Flag               | Description                                                                                                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `-field=<string>`  | Display only the value of the specified field (no trailing newline). Useful for scripting.                             |
| `-format=<string>` | Format the output as `table` (default), `json`, or `yaml`. Can also be set via the `VAULT_FORMAT`environment variable. |

***

**Examples**

* View versioned plugin info: `vhsm plugin info auth ratls`

```bash
Key                   Value
---                   -----
args                  []
builtin               true
command               n/a
deprecation_status    supported
name                  ratls
sha256                n/a
version               v1.3.7+builtin.vault
```

* View info for a built-in plugin: `vhsm plugin info database postgresql-database-plugin`

```bash
Key                   Value
---                   -----
args                  []
builtin               true
command               n/a
deprecation_status    supported
name                  postgresql-database-plugin
sha256                n/a
version               v1.3.7+builtin.vault
```

* Get only the plugin SHA256 hash: `vhsm plugin info -field=sha256 auth my-custom-plugin`

```
04ce575260fa3a2cfc477d13ac327108c50838a03917ec4d6df38ecdc64452d1
```