1. Home
  2. Get Started
  3. Web Wallet Installation

Web Wallet Installation

BitShares-UI depends node Node.js, and version 8+ is required.

On Ubuntu and OSX, the easiest way to install Node is to use the Node Version Manager.

To install NVM for Linux/OSX, simply copy paste the following in a terminal:

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.30.2/install.sh | bash
nvm install v9
nvm use v9

Once you have Node installed, you can clone the repo:

git clone https://github.com/ioBanker/bitshares-ui.git

Before launching the GUI you will need to compile the packages:

cd bitshares-ui
npm install
npm run install-charting-library
cd node_modules/bitsharesjs
npm install
npm run build-es
cd ../bitsharesjs-ws/
npm install
npm run build
cd ../../
npm run build

Running the dev server

The dev server uses Express in combination with Webpack.

Once all the packages have been installed you can start the development server by running:

echo fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
npm run start

Once the compilation is done the GUI will be available in your browser at: localhost:8080 or Hot Reloading is enabled so the browser will live update as you edit the source files.


By default bitshares-ui connects to the live BitShares network, but it’s very easy to switch it to the testnet run by Xeroc. To do so, open the UI in a browser, go to Settings, then under Access, select the Public Testnet Server in the dropdown menu. You should also change the faucet if you need to create an account, the testnet faucet address is https://testnet.bitshares.eu.

The UI will reload and connect to the testnet, where you can use the faucet to create an account and receive an initial sum of test BTS.



If you’d like to host your own wallet somewhere, you should create a production build and host it using NGINX or Apache. In order to create a prod bundle, simply run the following command:

npm run build