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

# vhsm plugin deregister

The `plugin deregister` command deregisters an existing plugin from vHSM's plugin catalog. If the plugin does not exist, no error is returned. The plugin's type of "auth", "database", or "secret" must be included.

#### Usage <a href="#usage-1" id="usage-1"></a>

The following flags are available in addition to the standard set of flags included on all commands.

* `-version` `(string: "")` - Semantic version of the plugin to deregister. If unset, only an unversioned plugin may be deregistered.
* `<plugin-type>`: The type of plugin (e.g., `auth`, `database`, or `secret`).
* `<plugin-name>`: The name of the plugin to deregister

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

**Available Flags**

| Flag                | Description                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| `-version=<string>` | Semantic version of the plugin to deregister. If not set, only an unversioned plugin will be removed. |

#### Example <a href="#examples-1" id="examples-1"></a>

Deregister a plugin:

```
vhsm plugin deregister auth my-custom-plugin
```

**Output**

```
Success! Deregistered plugin (if it was registered): my-custom-plugin
```