> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instances

> Learn what instances are and how to manage them in Blnk Cloud.

Instances are how you connect your Blnk Core to your Blnk Cloud workspace. There are two types of instances you can create on Cloud:

<CardGroup cols={2}>
  <Card title="Managed instance" icon="cloud" href="/cloud/instances/deploy">
    Instance deployed on Blnk Cloud.
  </Card>

  <Card title="Agent" icon="server" href="/cloud/instances/create">
    Self-hosted instance connected to Cloud.
  </Card>
</CardGroup>

***

## View instance details

To view instance details, click on an instance in the `Instances` table. You'll see an instance details panel opened on the right side of your screen.

<img src="https://mintcdn.com/blnk/JB9Zhph4DjE0VsHT/cloud/img/instances/instance-details-view.png?fit=max&auto=format&n=JB9Zhph4DjE0VsHT&q=85&s=d57dc7c7dfccba94b735e5cb565c3b16" alt="Instance details panel showing instance details" className="rounded-lg" width="3394" height="1958" data-path="cloud/img/instances/instance-details-view.png" />

***

## Edit instances

To edit an instance, go the `Settings > Instances`, open its actions list and click `Edit instance`. You can change the name, update the Core URL, or the Core secret key.

### Core URL

* Make sure it is publicly accessible on the internet. If locally hosted, use a tunnel service like ngrok: `ngrok http 5001` to create a public URL.

  <img src="https://mintcdn.com/blnk/JB9Zhph4DjE0VsHT/cloud/img/instances/edit-instance-form.png?fit=max&auto=format&n=JB9Zhph4DjE0VsHT&q=85&s=39b3f0ad8bdc0d72afd657770a677140" alt="Edit instance form showing Core URL and secret key fields" className="rounded-lg" width="3384" height="1976" data-path="cloud/img/instances/edit-instance-form.png" />

* If hosted on a private network, make sure to whitelist our IP addresses so that Cloud can communicate with your ledger:
  * `161.35.166.95`
  * `161.35.171.250`

### Core secret key

* This is created and set by you in your Blnk configuration.
* Provide the secret key used/created in your config here. If not set, leave empty.

***

## View Query Agent setup guide

To view the Query Agent setup guide, open the actions list or open the instance details panel and click `View setup details`.

In this page, you'll see your connection details, agent connection key, and other relevant information for setting up your Query Agent.

<img src="https://mintcdn.com/blnk/JB9Zhph4DjE0VsHT/cloud/img/instances/instance-connection-status.png?fit=max&auto=format&n=JB9Zhph4DjE0VsHT&q=85&s=c61f72eb20969aaa10490bda8c9b1cb2" alt="Query Agent setup guide page showing connection details and agent key" className="rounded-lg" width="3392" height="1950" data-path="cloud/img/instances/instance-connection-status.png" />

***

## Remove an instance

To remove an instance, open the actions list and click `Destroy instance` for a managed instance or `Terminate instance` for a self-hosted instance. Follow the instructions in the modal to complete the action.

Please note that this action is irreversible.

***

## 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 [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

**Need help with your product?**

Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.