Managing Blnk Plugins
Learn how to install and run plugins with the Blnk CLI.
Important to note: This is an experimental feature.
Plugins enhance and extend the capabilities of your Blnk Ledger by providing additional features and functionalities tailored to meet your needs. In this guide, you’ll learn all about plugins, and how to install and run plugins on your server.
Just like the Blnk Ledger, Plugins are also open-source. You can develop your own plugins for your project, but we require you to publish it on the Blnk Plugin public repository to be able to run them on your project using the Blnk CLI.
Installation
To install a plugin, run this command in your terminal
blnk plugins install <pluginName>
You can find the name of the plugin file in the Blnk Plugin public repository.
Basic commands
There are 4 basic commands that you can use to manage your installed plugins.
Run plugin
blnk plugins run <pluginName>
This command manually runs the plugin for you in the terminal.
When you run a plugin on a connected instance from your computer, the plugin is run on where the instance is hosted on.
Update plugin
blnk plugins update <pluginName>
This command updates the plugin to its latest version, if any.
List installed plugins
blnk plugins list
This command shows you a list of all your installed plugins and their basic information.
Delete plugin
blnk plugins delete <pluginName>
This command deletes a plugin from your list of installed plugin.
Practical example
In this example, we’ll install the “Hello World” sample plugin. This plugin simply prints “Hello World” once it is run.
Install the hello-world plugin
blnk plugins install hello-world
When it’s done, you get the following:
✔ Plugin hello-world installed successfully.
Warning: Plugin hello-world is not verified by Blnk. Use with caution.
While everyone is welcome to publish their plugins and contribute to Blnk’s open-source plugin directory, all plugins will go through an internal review process to verify their safety and ensure the security of our customers’ ledgers.
The warning sign is shown when the plugin has not yet been verified by the Blnk team.
Run the command
blnk plugins run hello-world
Here’s the response you get:
⠋ Running plugin hello-world...Hello World Plugin initialized
Hello World Plugin executed with event data: http://localhost:5001
✔ Plugin hello-world executed successfully.
Need help?
We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.
To ask questions or discuss issues, please join our Discord community.
Was this page helpful?