Knowledge Base

Search Knowledge Base by Keyword

Masternode Setup Guide

  • Home
  • Masternode Setup Guide



This guide is for a single Masternode, on a Ubuntu 16.04 64-bit server (VPS) running headless and will be controlled from the wallet on your local computer (Control wallet). The wallet on the VPS will be referred to as the Remote wallet.

You will need your server details for progressing through this guide.

First the basic requirements:

  1. 10,000 PIV (may need a fraction of a PIV more to cover for the transaction fee)
  2. A main computer (Your everyday computer) – This will run the control wallet, hold your collateral 10,000 PIV and can be not running without affecting the Masternode.
  3. Masternode Server (VPS – The computer/node that will be on 24/7)
  4. A unique IP address for your VPS / Remote wallet

(For security reasons, you’re are going to need a different IP for each masternode you plan to host)

The basic reasoning for these requirements is that, you get to keep your PIV in your local wallet and host your Masternode remotely, securely.


First of all, make sure that you are running the latest PIVX core wallet version, which is currently v4.0.0.

NOTE: Starting with version v3.4.0 of the PIVX core wallet, there has been changes to the commands that are commonly used when operating a Masternode. Notably RPC calls are no longer made from ./pivxd and command names have changed. Please see HERE for all Masternode RPC changes.

1) Using the control wallet, enter the debug console (Settings > Debug > Console) and type the following command:
(This will be the masternode’s privkey. We’ll use this later. For now just copy-paste it somewhere.)

2) Using the control wallet still, enter the following command:
getaccountaddress <AnyNameForYourMasternode>

3) Still in the Control wallet, send 10,000 PIV to the address you generated in step 2 (Be 100% sure that you entered the address correctly. You can verify this when you paste the address into the “Enter a PIVX address or contact label” field, the “Label address” below should auto-populate with the name you chose), also make sure this is exactly 10,000 PIV; No less, no more.)
Be absolutely 100% sure that this is copied correctly. And then check it again. We cannot help you, if you send 10,000 PIV to an incorrect address.

4) Still in the Control wallet, enter the command into the console:
getmasternodeoutputs (This gets the proof of transaction of sending 10,000 PIV)

5) Still on the main computer, we need to edit the masternode.conf. To do so, close the wallet, go to PIVX data directory, by default in Windows it’ll be %Appdata%/PIVX or Linux ~)

Now find and open the masternode.conf file with a text editor (notepad or so), add the following line to it:

 <Name of Masternode(Use the name AnyNameForYourMasternode you entered earlier for simplicity)> <Unique IP address>:51472 <The result of Step 1> <Result of Step 4> <The number after the long line in Step 4>

For example, your masternode.conf should like this:

Masternode1 892WPpkqbr7sr6Si4fdsfssjjapuFzAXwETCrpPJubnrmU6aKzh c8f4965ea57a68d0e6dd384324dfd28cfbe0c801015b973e7331db8ce018716999 1

Substitute it with your own values and without the “<>”s

VPS Remote wallet install

6) Install the latest version of the PIVX wallet onto your Masternode. The latest version can be found here:

  1. Go to your home directory: cd ~
  2. From your home directory, download the latest version from the PIVX GitHub repository: wget
    1. The link above is for Ubuntu (or similar), make sure you choose the correct version of the core wallet if you are not using Ubuntu from:
  3. Unzip and extract:  tar -zxvf pivx-4.0.0-x86_64-linux-gnu.tar.gz
  4. Go to your PIVX 4.0.0 bin directory: cd ~/pivx-4.0.0/bin
  5. Note: If this is the first time running the wallet in the VPS, you’ll need to attempt to start the wallet ./pivxd this will place the config files in your ~/.pivx data directory
    1. press CTRL+C to exit / stop the wallet then continue to step 8

Configuration Cont.

7) Now on the Masternodes, find the PIVX data directory here.(Linux: ~/.pivx) cd ~/.pivx

8) Open the pivx.conf by typing vi pivx.conf then press i to go into insert mode and make the config look like this:

 rpcuser=long random username
 rpcpassword=longer random password
 externalip=your unique public ip address
 masternodeprivkey=Result of Step 1

Make sure to replace rpcuser and rpcpassword with your own.

9) to exit the editor press esc then :wq! then press enter

Start your masternode

10) Now, you need to finally start these things in this order
– Start the daemon client in the VPS. First go back to your installed wallet directory, cd ~/pivx-3.4.0/binand then start the wallet using ./pivxd
– From the Control wallet debug console startmasternode alias false <mymnalias>
where <mymnalias> is the name of your Masternode alias (without brackets)

The following should appear:
“overall” : “Successfully started 1 masternodes, failed to start 0, total 1”,
“detail” : [
“alias” : “<mymnalias>”,
“result” : “successful”,
“error” : “”

– Back in the VPS (remote wallet), start the Masternode ./pivx-cli startmasternode local false
– A message “masternode successfully started” should appear

11)Use the following command to check status:

./pivx-cli getmasternodestatus

You should see something like:

“txhash” : “334545645643534534324238908f36ff4456454dfffff51311”,
“outputidx” : 0,
“netaddr” : “”,
“addr” : “D6fujc45645645445645R7TiCwexx1LA1”,
“status” : 4,
“message” : “Masternode successfully started”

Congratulations! You have successfully created your Masternode!

Now the Masternode setup is complete, you are safe to remove “enablezeromint=0” from the pivx.conf file of the control wallet.

Tearing down a Masternode

1) How do I stop running MN1 on my VPS hoster and delete MN1 from my ‘PIVX Core – Wallet’?

a) ./pivx-cli stop from the Masternode to stop the wallet.
b) Then from your controller wallet PC, edit your masternode.conf, delete the MN1 Masternode line entry.
c) Now restart the controller wallet.
d) your 10K will now be unlocked.

2) How do I get the 10k PIV back that I’ve send to my MN1 address at the beginning of the MN1 setup?

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 10k PIV normally on my wallet then again, and sell it or stake it normally like before?

Yes! It can be unlocked and transferred at any time.