What's new

Masternode Setup Guide


Staff member


This tutorial will guide you in detail through the steps necessary to setup a PIVX masternode on Ubuntu 18.04 64-bit remote server (VPS) that is controlled via your local Control wallet. Your local wallet is not required to be kept open and you can store it as a cold wallet whilst still collecting masternode payments. There are other ways to setup masternode, but this one is highly recommended as it’s one of the most secure ways. If you need any additional help, feel free to join PIVX Discord and ask for a help in #support channel. DO NOT receive any help or assistance through private messages, because there are many impersonators showing up as PIVX team members that are trying to steal coins from you! They might look legit, but it’s high likely they are scammers. No one ever from PIVX team will contact you privately and offer you help. Every help will be offered in public support channel!

Basic requirements:

  1. Local system – your everyday computer, which will run Control wallet and hold the masternode coins
  2. Remote VPS with Ubuntu Server 18.04 64-bit OS installed with unique IP address that is running 24/7
  3. Minimum VPS specs: 50 GB of storage space, 2 GB of RAM, 1 dedicated CPU core
  4. Latest PIVX Core wallet release: v5.2.0.1
  5. 10,000 PIVX (good to have 10,001 to make sure you can cover transaction fee)
(NOTE: You will need a different IP address for each masternode you plan to host.)

Configuration of your Control wallet
Step 1 – Download PIVX wallet

Download the most recent version of the PIVX Core wallet here:

Step 2 – Extract and install the wallet

Choose the proper version for your operating system. Extract it, install and run the wallet. After starting the wallet for the first time, it will offer you to make a default PIVX data directory. Depending on your operating system, the default directory should be similar to:

The above example of default directory is Windows based.
If you choose your own location ensure that you record where that is.

Step 3 – Create a Masternode using Creation Wizard

First of all, make sure that you have 10,000 PIV in your wallet (in fact, 10,001 PIV to make sure you are able to cover the transaction fees).

  1. Unlock the wallet.
  2. Go to “Masternodes” tab.
  3. Click “Create Masternode Controller“.
  4. Masternode Creation Wizard intro window will open. It just reminds you that you need to have 10,000 PIV in your wallet in order to create a Masternode. Just click the “Next” button.
  5. Now you need to type the Masternode name as per your wish (i.e. “Masternode01”) and then click “Next” button again.
  6. Now you will be asked to type the IP address of your VPS (it might look similar to “”), and then click “Next” button again.
  7. If everything went successful, you should get a message “Master node created!”.
  8. Status of the newly created Masternode will be “MISSING”. That is normal in this phase.
We will get back here to Control wallet little bit later after we setup VPS.

VPS Remote wallet installation
These procedures are for a clean server install. If you have an existing installation then some steps may not be required. Performing the steps is unlikely to have any effect on the system. Securing the server has NOT been included in this tutorial. That is your responsibility. Although it’s not required, a great guide can be found here to assist you.

To be able to access a VPS, you need a software/SSH client like PuTTY for example. You can choose between alternatives as well, but this tutorial will not include installation of such software. After you successfully login to your VPS, follow the further steps.

Step 1 – Install most recent security patches

A clean server install will likely need some software updates. Enter the following command which will bring the system up to date:

sudo apt-get update && sudo apt-get -y upgrade
Step 2 – Download and extract PIVX Core wallet for Linux

Enter the following command lines one by one to download and extract PIVX wallet:

cd ~ && wget https://github.com/PIVX-Project/PIVX/releases/download/v5.2.0.1/pivx-
tar -zxvf pivx- && sudo rm -f pivx-

Masternode Configuration
Step 3 – Create the masternode configuration file and populate

Before the node can operate as a masternode a custom configuration file needs to be created. Since we have not loaded the wallet yet, we will create the necessary directories and the configuration file by typing the following command lines one by one:

mkdir ~/.pivx && cd ~/.pivx && sudo apt-get install nano && touch pivx.conf && nano pivx.conf
This command has created a blank PIVX configuration file where we will enter our masternode configuration variables. Now we should properly setup configuration settings.

Paste the following configuration settings into the editor (using PuTTY, paste is being done simply by right mouse click):

Before you exit the editor, there are 3 parameters that you need to update with your own settings. These are:

  • <YOUR_OWN_RPC_USERNAME> – Set this to a custom username. i.e. rpcuser
  • <YOU_OWN_RPC_PASSWORD> – Set this to a STRONG password. i.e. password<– NO!!! Use something more complex for your own safety!
  • Now go back to Control wallet in Masternode tab, click on the 3 dots next to Masternode you created few steps above and then click “Info“.
  • Now click icon next to “Export data to run the Masternode on a remote server“.
  • It will now ask you for a confirmation to export required data to run a Masternode. Click “OK” button.
  • Now you will get a message that required info was successfully exported (copied to your clipboard) and now you should paste it in your pivx.conf file on your VPS under themaxconnections=256 line in pivx.conf file.
  • After all, your pivx.conf file on your VPS should look like:
    Save and exit the editor by pressingCTRL-Oand Enterto save andCTRL-Xto exit the editor.

    Start your masternode
    Step 4 – Load the masternode
    With the configuration created we are now ready to load the masternode and sync to the network. Load the masternode by typing the following command:
    cd ~/pivx- && ./pivxd
    You will get the message “PIVX server starting”. To follow the progress until the wallet is fully loaded and synchronized, type:
    tail -f ~/.pivx/debug.log
    Wait until you see the message similar to:
    2020-01-10 13:31:01 CMasternodeSync::GetNextAsset – Sync has finished
    2020-01-10 13:31:01 CActiveMasternode::ManageStatus() – not capable: Hot node, waiting for remote activation.

    Once you get this message, you are completely synced and masternode is ready to be started. PressCTRL-C to get back to command line.

    ./pivx-cli getbestblockhash
    You will get back hash that will look like:
    Paste the number you get after./pivx-cli reconsiderblockcommand like this:
    ./pivx-cli reconsiderblock 1ab2a12a1a1a121a1212ab1aba121212121ab1a1a12a12121aba1a1abab1212aa1
    Finally, type:
    ./pivx-cli clearbanned
  • NOTE: Wait for 15 confirmations on the blockchain for transaction with the masternode collateral before proceeding with the next steps below.
    Now go back to your Control wallet -> Masternodes -> Click “Start Inactive/s”
    Status will change from MISSING -> ACTIVE.

    Now go back to your VPS and type:
    ./pivx-cli startmasternode local false

    If everything went well, you should receive the following message:
    “Masternode successfully started”
    Congratulations! You have successfully started your masternode!
    1) if the output of getmasternodestatus is fine, then you are perfectly fine. But have in mind that it can take up to 2 hours for masternode to change status from ACTIVE to ENABLED in the masternode list.
    2) First masternode reward requires a longer waiting period. It usually takes 3-5 days to receive a first masternode reward.
    3) You can close the Control wallet, as it is not needed. Only VPS should be working 24/7.
  • If you have any troubles or issues, feel free to join PIVX Discord and post your question in #support channel. Again, DO NOT ever receive any help or assistance through private messages, as there are many scammers out there trying to steal your coins, even if they look the same as developers, admins or support staff. Every help ever will be provided through public channels.
    Shutting down a Masternode
    1) How do I stop running masternode on my VPS and delete masternode from my PIVX Control wallet?
    a) In Control wallet in Masternode tab click on Masternode you wish to shutdown and click “Delete”.
    b) Restart the wallet.
    c) Your 10,000 coins are now unlocked and spendable.
    2) How do I get the 10,000 PIVX back that I’ve send to my Masternode address at the beginning?
    You don’t need to “get it back” as it is already in your wallet.
    Being in the different address is not an issue as that’s also your address.
    3) Can I use this 10,000 PIVX normally on my wallet then again, and sell it or stake it normally like before?
    Yes! If your wallet is unlocked for staking, it will automatically stake these 10,000 coins and you can spend them at any time.
For people doing it the first time i think you also need to do this:
cd ~/pivx-5.1.0/ && ./install-params.sh
before starting the wallet or it will complain.
For people doing it the first time i think you also need to do this:
cd ~/pivx-5.1.0/ && ./install-params.sh
before starting the wallet or it will complain.
Thank you, originally firo master node not fix this problem very helpless again