Guide To Set Up XinFin Master Node

XinFin offers the first and only genuinely one-click masternode deployment. Our Masternode One-Click Installer has been heralded by many as the easiest solution for setting up a masternode and earning XDC.

You can download the latest 64-bit stable release of XinFin - One Click Installer for our primary platforms below. Packages for all supported platforms, as well as develop builds, can be found further down the page.

Download XinFin One Click Installer (to setup Masternode) for Windows and Linux

Windows (64-bit)



Coming Soon!

Before You Begin

This guide will demonstrate how to set up a single masternode for the very first time. You will need the following before starting:

  1. At least 10,000,000 XDC with masternode holder to perform proof-of-stake consensus seamlessly.
  2. Wallet to store XDC tokens, preferably hardware.
  3. Dedicated and stable hardware environment.
  4. Dedicated Static Public IP address.
  5. 100% network uptime by IDC network.
  6. Minimum tier 3+ IDC environment.
  7. (Optional, but highly recommended) Virtual Private Server (VPS).
  8. For cloud based services, Amazon EC2's m3.large VM size would be appropriate. Similar configuration is applicable for Microsoft Azure Cloud network.

This guide will cater to the following system configurations:

Operating System

CentOS or RedHat Enterprise Linux (latest release) or Ubuntu (15.04+) supported


Windows (64-bit) or most Linux distributions


64-bit x86_64, 2+ cores


Minimum 300GB SSD recommended (500+ IOPS, more is better) for the database partition


32 GB

About XinFin Masternode

XinFin's token XDC supplants proof-of-work consensus algorithm (popularly linked with mining) with proof-of-stake consensus algorithm, fundamentally using the concept of "validators".

Validators are special nodes used in the XDPoS consensus algorithm which validate each transaction occurring on the blockchain network. The result of this validation is to finally append the transaction on the blockchain. A transaction may be accepted by the validator or rejected. (Important: There can be multiple validator nodes in each network.)

Decisions made by these validator nodes are broadcasted through the network as messages which are signed (attested) using validated cryptographic public key. Every validator node running XDC protocol in the RCL network is responsible for deciding its Unique Node List (UNL). This list holds information about which regular nodes does the validator care about.

To set up a masternode, make sure your XDC protocol running node is publicly identified and has gone through the compliance process. Every Node Holder need to upload KYC document and this detail will be visible to the public network.

Why set up a masternode at all?

It is necessary to set up a masternode to operate on XDC protocol because masternodes make the decentralised blockchain network self-sustainable. Deploying masternode is conducive to trusted, scalable decentralised network infrastructure. Such an environment facilitates greater stability and reliability on the network.

Functions of masternode

In XDPoS blockchain environment, masternode concept is cardinal to the functioning. A masternode validates each (or segment of transaction depending upon UNL) transaction and is also responsible for writing the transaction onto the truth ledger: the blockchain. As a consequence, this makes decentralised governance of the network possible.

Restrictions on nodes which aspire to become masternodes

Nodes which possess any of the below mentioned characteristics may not qualify to become masternodes:

  • Anonymous entity on the network.
  • Intentions to fork XDC Software.
  • Entity or Individual with Criminal record in past.
  • Entity or Individual which does not comply with local law of land.

Incentives to set up your own masternode

Several reasons why setting up a masternode is useful are:

  • Reputation building within the network community.
  • Trust Factor enhances for your node particularly since network relies on your node.
  • More Incentive gain as your node pushes more transactions on network.
  • Private blockchain is capable of running its own use case.

Important: Max number of Master node allowed in the network is 5000.

Special incentives for 18th validator node: Information required Depends on No's of Block created by validator node (incentive In terms of XDC)

Reward Cycle: Every Epoch.


What is Masternode Node?

Masternode is simply a cryptocurrency full node or computer wallet that keeps the full copy of the blockchain record in real-time.

What is Validator node?

In XinFin, "Validator Node" are full nodes that incentivize node operators to perform the core consensus functions of running a XDPoS based blockchain. Only Validator Node gets incentive to validate the transaction.

How to become a Validator Node?

To become a Validator Node, refer this article :

Near zero transaction fees on network, how validator gets incentive?

Network generate additional coin to provide incentive to validator node. Nos depends on network load and numbers of transaction process within the network.

How to get XDC ?

XDC is listed with more then 20 Liquidity Exchanges. The full list of exchanges is available at so that you can purchase XDC from open market to stake under masternode.

Hands on guide: How to Setup Masternode

There are two methods to choose from to set up the masternode:

  1. DIY masternode environment set up
  2. Delegate masternode set up to third party service provider

METHOD 1: DIY Masternode environment set up

CentOS or RedHat Enterprise Linux (latest release) or Ubuntu (15.04+) supported

Clone repository

git clone

Enter XinFin-Node directory

cd XinFin-Node

Step 1: Install docker & docker-compose

sudo ./

Step 2: Update .env file with details

cp env.example .env
nano .env

Step 3: Start your Node


sudo docker-compose -f docker-services.yml up -d

Your coinbase address can be found in xdcchain/coinbase.txt file.

To stop the node or if you encounter any issues use:

sudo docker-compose -f docker-services.yml down


To upgrade please use the following commands

sudo docker-compose -f docker-services.yml down
sudo ./
sudo docker-compose -f docker-services.yml up -d


If you are having problems with Setup, the first step is to collect more information to accurately characterize the problem. From there, it can be easier to figure out a root cause and a fix.

METHOD 2: Delegate masternode set up to third party service provider

Set up your Masternode using one of these 3rd party Masternode service providers.

DISCLAIMER: This list is provided for informational purposes only. Services listed here have not been evaluated or endorsed by XinFin and no guarantees are made as to the accuracy of this information. Please exercise discretion when using third-party services.

List of service provider to Setup masternode

    • IPv6 and tor Supported
    • Global geographical locations
    • Fully Managed Network
    • Network attack prevention (DDoS)
    • One time Setup Cost: Free
    • Monthly: 250 USD (pay in XDC, Paypal, debit, or credit card)

Are you a Provider?

If yes, then Contact us to List your service.

Masternode Tools

Where to operate? Mainnet vs Testnet:

In XinFin, there are two networks where you can run XDC protocol: the mainnet and the testnet.

The mainnet is used to transact real XDC. The XDC's value is tied to real fiat currency via cryptocurrency exchanges.

As developers, you do not want to run application tests with real money. That is what the testnet is for. We call the testnet XinFinTestNet.