# vhsm plugin list

The `plugin list` command lists all available plugins registered in vHSM's plugin catalog. It can list all plugin types or be filtered by specific types such as `auth`, `database`, or `secret`.

The output includes a Deprecation Status column for built-in plugins, helping users track the plugin lifecycle. Non-builtin plugins will show a Deprecation Status of `"n/a"`.

**Usage**

```bash
vhsm plugin list [options] [plugin-type]
```

* `[plugin-type]` *(optional)*: Limit the output to a specific plugin type — `auth`, `database`, or `secret`.

**Available Flags**

**Command options**

| Flag        | Description                                                             |
| ----------- | ----------------------------------------------------------------------- |
| `-detailed` | Show extended output including container status and deprecation status. |

**Output options**

| Flag               | Description                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| `-format=<string>` | Format output as `table` (default), `json`, or `yaml`. Can also be set via the `VAULT_FORMAT` environment variable. |

&#x20;**Examples**

* List all plugins in the catalo&#x67;**:** `vhsm plugin list`

```bash
Name                                 Type        Version
----                                 ----        -------
alicloud                             auth        v0.13.0+builtin
cassandra-database-plugin            database    v1.13.0+builtin.vault
```

* List only database plugins: `vhsm plugin list database`

```bash
Name                                 Version
----                                 -------
cassandra-database-plugin            v1.13.0+builtin.vault
```

* List all plugins with detailed output: `vhsm plugin list -detailed`

```bash
Name                                 Type        Version                 Deprecation Status
----                                 ----        -------                 ------------------
alicloud                             auth        v0.15.0+builtin         supported
approle                              auth        v1.3.7+builtin.vault    supported
aws                                  auth        v1.3.7+builtin.vault    supported
azure                                auth        v0.16.0+builtin         supported
centrify                             auth        v0.15.1+builtin         supported
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enclaive.cloud/virtual-hsm/cli/configuration-and-management/vhsm-plugin/vhsm-plugin-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.