Time to get your hands dirty. The installation may be slightly more technical than what you are used to, but by following along, you should have BB up and running in no time. Start with the following three steps:

1. Install Node.js

For Windows

For macOS


Install with the default settings

2. Install Git

For Windows

For macOS


Install with the default settings

3. Install Balance Bot

Download the BB installer here

(for both Windows and macOS)


Follow the instructions below

Install Balance Bot

BB comes with an installer, which needs to be downloaded and stored on your PC. The installer will then download and install the actual BB application. You can also use the installer to conveniently install future BB updates.

After downloading the BB installer above, follow these steps:

  1. Unzip the file and copy/move the balance-bot folder to a place that’s easily accessible. It’s recommended to go for the root of your drive, so the installer is available in c:\balance-bot

BB is now installed on your system. Well done, the hard part is over!

Starting Balance Bot

To start BB, from the same folder (e.g. c:\balance-bot), type: node bb

Then open http://localhost:3000 in your browser.

NOTE: make sure that you stop BB (see below) before putting to sleep, switching off, or rebooting your PC, to avoid BB’s configuration files getting corrupted. There is a very small chance that this happens, only when BB is abruptly stopped while it is updating a config file at that exact moment. But the chance is not zero. So please keep this in mind.

Stopping Balance Bot

To stop BB, from within the Command Prompt or Terminal window where you started BB, type CTRL+C / Control+C once or a few times, until the prompt appears.

Updating Balance Bot

To install an update of the BB application, simply open the Command Prompt (Windows) or Terminal (macOS), go into the BB folder (e.g. c:\balance-bot), and type: node install

Choose option 2 from the menu, and the latest version will be installed. Once the process completes, restart BB by typing node bb again.

Reinstalling Balance Bot

In some cases, an update may not work because of a breaking change. To address this, the installer offers the option to re-install BB. To do so, type node install, and choose option 3 from the menu. This will result in a clean install of BB, but the settings and bot configuration data will be maintained.