No announcement yet.

Manual: How do you install your own node

This topic is closed.
  • Filter
  • Time
  • Show
Clear All
new posts

  • Manual: How do you install your own node

    Dear Community

    All those who want to support the blockchain have the possibility to install their own node. A node is a computer (server) through which the transactions are handled. You can find the current nodes at click on the button "Peerexplorer".

    In this manual, I will show all interested people how to set up their own node on a Linux server. IMPORTANT: I personally only recommend, if you are familiar with a server, or do you have the technical know how to operate a dedicated server. The whole setup, operation and maintenance of a server is your own thing. This guide has been created to the best of my knowledge. The installation happens at your own risk, I do not give any support.

    Basiv data:

    First you need your own root server or a vServer with the operating system Linux, which you can manage via SSH. My node runs on Ubuntu 16.04.1 LTS. From your server or provider, you need the following access data to set up a node:

    - Own IP adress
    - Username (usually this is "root")
    - Password


    If you work with Windows you need a software to get via SSH to your server, as an example "Putty". On Mac you can use the preinstalled software "Terminal". If you have the software or the terminal open you write the following:

    ssh [email protected]"your own IP-Adress" oder ssh "your username"@"your IP-Adress"
    Now appears the message whether you really want to establish a connection. You confirm this with "yes" or "j", depending on the server settings.

    If you can not log in directly with the "root" user, log in with another user. After the login, you change to the "root" user with the following command:

    su root
    First you have to update your package manager. To do this, enter the following in Putty or Terminal:

    apt-get update
    Now download the zip-file core-build to your server

    To verify that you have really downloaded the correct file, run this command:

    As a result, this should be displayed: "3a9fbba47594664346fd73efc1baabf755282597dccc8 5cae b3b489a497c7e62"
    To unzip the zip file you need "unzip". Execute the following commands to install "unzip":

    apt-get install unzip
    Now unpack the file with:

    This takes a small moment. Now all the files are unpacked and we no longer need the zip file. Delete this with the command:

    Now we record certain settings for your node. Execute the following commands one by one:

    cd core
    vim bin/conf/
    In order for your node to function correctly, you enter various settings here. The first thing you do is to insert "xin.myAddress =" your IP address after the =. Then, in the API section of the first three entries, you remove the diamond # and for "xin.adminPassword =" you enter behind the = a secure password, which you will not use anywhere else. Click image for larger version  Name:	Bildschirmfoto 2017-04-23 um 18.04.02.png Views:	1 Size:	23.4 KB ID:	9768

    You can leave the editor by pressing the "ESC" -key and then press ": X" to save the settings and return to the previous view. The next thing you need is Java. This will install again with a separate command:

    apt-get install default-jre
    In order for your node to continue running when you disconnect the server, you need another software. You start with:

    Now you start your node. To do this, first go to the correct directory:

    cd /core/bin
    And then you start the node with the command:

    You will now see again how your server (node) starts to work. He will now synchronize the blockchain. This will take some time. To continue, press "crtl" on your keyboard, then press the "a" button, then "d", then release the "ctrl" button.

    Now write the next command. Make sure that you enter the missing data. These are your IP address and passphrase:

    curl -d requestType=markHost -d host=Your IP-Adress -d weight=1 -d date=JJJJ-MM-DD -d secretPhrase=„Your Passphrase” http://Your IP-Adress:23457/api
    You are now receiving a Hallmark code. From this code, you only need the numbers and letters: {"hallmark": "to", "requestProcessingTime": 35}
    Copy this hallmark to the clipboard or to a Word document. We need this Hallmark again.
    Now go back to the file "". You can find them as follows (maybe you have a different folder structure):

    vim /core/bin/conf/
    Add the Hallmark to the entry "xin.myHallmark =". Click image for larger version  Name:	Bildschirmfoto 2017-04-23 um 18.03.51.png Views:	1 Size:	24.5 KB ID:	9767

    To exit the editor, press "ESC" again and then ": X" to save.

    Now we go back to where your Node was running to work:

    screen -r
    Please restart your node. To do this, first press "ctrl + c" and enter the following command for the restart. First open the directory with "cd" and then run the "core" file:

    Now you need the software "Screen" again, so the node is working in the background. Press "ctrl" again and the "a" key and then "d". Now you can release "ctrl" again. You return to the previous view to execute the next command. This starts the Forging:

    curl --data "requestType=startForging" --data-urlencode "secretPhrase=Your Passphrase” http://Your IP-Adress:23457/api
    Now your own node is running. So all work is completed. To disconnect, use:


    Good luck setting up...

  • #2

    The instructions described above are designed for installation on a server with Linux and not for the PC at home. The operation of a server I recommend only people who are familiar with it.