Skip to content
World's first KYC compliant Blockchain :
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

World's first KYC compliant Blockchain :


Belrium system is a decentralized application platform, which is designed to lower the threshold for developers, such as using JavaScript as develop language, supporting relational database to save transaction data, and making DAPP development be similar with traditional Web application. It is sure that these characteristics are very attractive to developers and SMEs. The ecosystem of the whole platform cannot be improved until developers make a huge progress on productivity. Also, Belrium platform is designed to be open for various fields, not limited to some particular parts such as finance, file storage, or copyright proof. It provides underlying and abstract API which can be combined freely to create different types of applications. In consensus mechanism, Belrium inherits and enhances DPOS algorithm, by which the possibility of forks and risk of duplicate payments would be significantly reduced. Furthermore, Belrium sidechain mode not only can mitigate the pressure of blockchain expansion, but also make DAPP more flexible and personal. Belrium system, as a proactive, low-cost and full stack solution, will surely be a next generation incubator of decentralized applications.

System Dependency

  • nodejs v6.2.0+
  • npm 3.10+ (not cnpm)
  • node-gyp v3.6.2+ (suggested)
  • sqlite v3.8.2+
  • g++
  • libssl

Steps to setup new belrium mining node:

  1. Register and create wallet on
  2. Verify your email and activate your wallet.This information is purely confidential. Please do not disclose this with anyone.
  3. You can now upload documents based on your geography and get your wallet compliance checked.Once your wallet is compliant you can start transacting on the belrium network.
  4. Get the source code hosted at -
  1. Run the following commands to install the required software dependencies.
    System Dependency
    nodejs v6.3+,npm 3.10+ (not cnpm),node-gyp v3.6.2+ (suggested),sqlite v3.8.2+,g++,libssl,

Installation dependencies for ubuntu 14.04.x or higher using bash script.

   sudo ./belrium_manager.bash install

Installation dependencies for ubuntu 14.04.x or higher manually.

Install dependency package

   sudo apt-get install curl sqlite3 ntp wget git libssl-dev openssl make gcc g++ autoconf automake python build-essential -y

libsodium for ubuntu 14.04

   sudo apt-get install libtool -y

libsodium for ubuntu 16.04

   sudo apt-get install libtool libtool-bin -y

Install node and npm for current user

curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

For other operating systems follow :

Install node packages

  npm install

Installation on docker.

Please install Docker firstly

# pull belrium code docker image
docker pull belriumplatform/belrium:v1.3.0
# run docker and belrium
docker run -i -t --name belrium1.3.0 -p 4096:4096 belriumplatform/belrium:v1.3.0 /bin/bash
root@e149b6732a48:/# cd /data/belrium && ./belrium start
Belrium server started as daemon ...
  1. To connect with the Belrium blockchain, new node need to change the setting file (Belrium->config.json) with following information.
    "port": 9305,
    "address": "",
    "publicIp": "",
    "logLevel": "debug",
    "magic": "594fe0f3",
    "api": {
        "access": {
            "whiteList": []
    "peers": {
        "list": [{
            "ip": "",
            "port": 9305
        "blackList": [],
        "options": {
            "timeout": 4000
    "walletVerificationAPI": {
        "enable": false
    "forging": {
        "secret": [],
         "access": {
            "whiteList": [""]
    "loading": {
        "verifyOnLoading": false,
        "loadPerIteration": 5000
    "dapp": {
        "masterpassword": "",
        "params": {}
    "ssl": {
        "enabled": false,
        "options": {
            "port": 443,
            "address": "",
            "key": "./ssl/server.key",
            "cert": "./ssl/server.crt"
    "url": {
        "kycUrl": ""

  1. Run the following script to start the node
./belrium_manager.bash start

screen shot 2018-07-30 at 5 44 52 pm

  1. Run the following command to stop the node
./belrium_manager.bash stop

screen shot 2018-07-30 at 5 47 35 pm

  1. Run the following script to know the status
./belrium_manager.bash status

screen shot 2018-07-30 at 5 35 39 pm


cd belrium && node app.js
cd belrium && ./belrium_manager.bash start

Then you can open http://localhost:9305 in you browser.


node app.js --help

  Usage: app [options]


    -h, --help                 output usage information
    -V, --version              output the version number
    -c, --config <path>        Config file path
    -p, --port <port>          Listening port number
    -a, --address <ip>         Listening host name or ip
    -b, --blockchain <path>    Blockchain db path
    -g, --genesisblock <path>  Genesisblock path
    -x, --peers [peers...]     Peers list
    -l, --log <level>          Log level
    -d, --daemon               Run belrium node as daemon
    --reindex                  Reindex blockchain
    --base <dir>               Base directory
You can’t perform that action at this time.