> 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-list.md).

# 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
```