> For the complete documentation index, see [llms.txt](https://docs.bluzelle.com/bluzelle-heroku-addon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluzelle.com/bluzelle-heroku-addon/master.md).

# README

## Bluzelle Heroku Add-on

![](https://2482955159-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXMR_HFdvqjkmqaPhhs%2F-LaZcndrlfo9tF6WiUOE%2F-LaZd4unrgjnkzQup39_%2Fheroku-logotype-horizontal-purple.png?alt=media\&token=325926a6-0821-465f-a345-988ca8488636)

The Bluzelle Heroku Add-on is a great addition to your Heroku Application. Currently in Alpha, the add-on can:

* Automatically create environment variables, in your Heroku Application, to enable connection to our testnet
* Provide a dashboard to manage data that your Heroku Application committed to testnet

## Prerequisites

* Nodejs/npm
* Heroku CLI
* A deployed Heroku Application making calls to the Bluzelle database

> If you require assistance creating an application that uses the Bluzelle API, please visit this video: <https://www.youtube.com/watch?v=u55BgUrzYDg> Alternatively, here is the write up for building a simple Nodejs application using the Bluzelle API <https://blog.bluzelle.com/javascript-support-in-bluzelles-lovelace-release-e2b3454ffc0d>

## Instructions

1\) Login to Heroku using the Heroku CLI:

```bash
$ Heroku login
```

2\) Once you've logged into Heroku with the Heroku CLI, you can now install the add-on to your Heroku Application (where APPLICATION\_NAME is the name of your Heroku Application)

```bash
$ Heroku addons:create bluzelledb:test -a APPLICATION_NAME
```

3\) If everything went smoothly and the add-on installed properly, you will find 3 Config Variables (In your Heroku Application Dashboard, under the settings tab, you should see Config Vars. If you Click on "Reveal Vars", you will see 3 Config Variables that the Bluzelle Add-on had set, BLUZELLEDB\_ADDRESS, BLUZELLEDB\_PORT, and BLUZELLEDB\_UUID)

## Using the Config Vars in your Application

Taken from the example in:

> <https://blog.bluzelle.com/javascript-support-in-bluzelles-lovelace-release-e2b3454ffc0d>

the line where you are connecting to testnet:

```bash
bluzelle.connect('ws://testnet.bluzelle.com:51010','45498479–2447–47a6–8c36-efa5d251a283');
```

can be replaced with environment variables that were set by the Add-on:

```bash
bluzelle.connect(process.env.BLUZELLEDB_ADDRESS +':'+ process.env.BLUZELLEDB_PORT,process.env.BLUZELLEDB_UUID);
```