Installing Plugins

Vultrino plugins can be installed from local paths, git repositories, or archive URLs.

Installation Sources

From Local Path

Install a plugin from a local directory:

vultrino plugin install ./my-plugin
vultrino plugin install /absolute/path/to/plugin
vultrino plugin install ~/plugins/my-plugin

From Git Repository

Install directly from GitHub, GitLab, or other git hosts:

# Latest commit
vultrino plugin install https://github.com/user/vultrino-plugin

# Specific tag or branch
vultrino plugin install https://github.com/user/vultrino-plugin#v1.0.0
vultrino plugin install https://github.com/user/vultrino-plugin#main

From Archive URL

Install from a .tar.gz archive:

vultrino plugin install https://example.com/plugin-1.0.0.tar.gz

Build Process

When installing a plugin with a Cargo.toml, Vultrino automatically:

Checks for the wasm32-wasip1 target (installs if needed)
Runs cargo build --release --target wasm32-wasip1
Copies the built WASM module to the plugin directory

Requirements:

Rust toolchain installed
rustup available in PATH

Managing Plugins

List Installed Plugins

vultrino plugin list

Example output (a table; use --format json for machine-readable output):

NAME                 VERSION    SOURCE                         CREDENTIAL TYPES
------------------------------------------------------------------------------------------
public-transform     2.0.0      https://github.com/exampl...   -

View Plugin Details

vultrino plugin info public-transform

Remove a Plugin

vultrino plugin remove public-transform

Reload a Plugin

vultrino plugin reload <name> only checks that the installed plugin loads. It does not reload a running server: restart vultrino web / vultrino mcp to pick up a changed module.

vultrino plugin reload public-transform

Plugin Discovery

Plugins can be discovered in the Vultrino plugin registry (coming soon) or by searching GitHub for repositories tagged with vultrino-plugin.

Troubleshooting

Build Fails

If the WASM build fails:

Ensure Rust is installed: rustup --version
Check the target: rustup target list --installed
Install the target manually: rustup target add wasm32-wasip1

Vultrino requires the credential-confining WASM ABI v2. ABI v1 modules are rejected because they accepted plaintext credential data. Installation validates the module and ABI before it is copied into the plugin directory.

Check the plugin manifest is valid:

cd ~/.local/share/vultrino/plugins/my-plugin   # Linux default; or $VULTRINO_PLUGIN_DIR/my-plugin
cat plugin.toml

Verify the WASM module exists:

ls -la *.wasm

Changed Plugin Not Picked Up

A running server does not hot-reload plugins. Restart it after installing, replacing or removing a plugin.

Vultrino Documentation