Skip to main content

Documentation Index

Fetch the complete documentation index at: https://guide.cloud.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

This feature is in private beta. If you want access, please contact Support.
This guide shows you how to install an app from the Apps library in Blnk Cloud. When you install an app, it becomes available inside the organization and Cloud instance you selected. This means an app can be installed in one instance and unavailable in another. Before you start, check that you are in the right organization and have selected the instance where you want the app to be available. The Apps library can include two types of apps:
  • Official apps: Built and managed by Blnk.
  • Private apps: Built and managed by your organization.
The installation flow is the same for both. However, private apps need to be registered in your workspace before they can be installed.

Prerequisites

If your instance is deployed on Cloud, you’re set to go. For connected self-hosted instances:
  • Make sure you set your Core URL and Core secret key in your instance details.
  • Make sure your Core URL is reachable. If your Core is set up in a private network, whitelist the Cloud IPs to ensure secure access to your Core via Cloud.

Install a Custom App

To install a Custom App:
1

Open Apps library

Navigate to the bottom left section of your side navigation and open the Apps library.
Note: Make sure you’re in the right instance where you want the app to be available. If you’re not sure, you can confirm by checking the active instance in the top right corner of your screen.
2

Choose an app

Browse the library for the app you want, and click to open its details.Review what it does, the permissions it requires, and any other details you need. Confirm that this is the app you need, then click Install.
3

Review permissions

Next, review what the app is allowed to access or do inside your ledger. This helps protect your data and ensures the app only does what you want it to.
  1. Review the requested permissions.
  2. Select the permissions you want to grant.
  3. Click Continue if you’re happy with the permissions.
4

Confirm installation

Finally, confirm the installation by entering your account password and 2FA code (if enabled).This final step helps protect the workspace from unauthorized app installs.
Now you can launch the app from the app details page by clicking Launch app from the top right corner of the app details page.

Uninstall a Custom App

To uninstall a Custom App:
1

Open the app details

From the Apps library, open the app you want to uninstall.Make sure you are viewing the same organization and instance where the app is installed.
2

Uninstall the app

Click Uninstall from the app details page.If uninstall fails, wait a few minutes and try again.

Troubleshooting

If something goes wrong during installation, here are a few things you can try:
IssueWhat to do
Permissions do not loadReopen the install flow and try again.
Password or 2FA is incorrectCheck your password or 2FA code and try again. You may see Authentication failed.
Install failsReturn to the app details page and click Install again.
App is not visible after installConfirm that you are viewing the same organization and instance where the app was installed.
Private app not loadingCheck that your app is live and accessible via Cloud.

Need help?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at support@blnkfinance.com or send us a message here.