Knowledge Base

Search Knowledge Base by Keyword

Masternode Setup Guide

  • Home
  • Masternode Setup Guide

Contents

Introduction

This guide is for a single masternode, on a Ubuntu 16.04 64bit 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.

Configuration

NOTE: Starting with version v3.4 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 (Tools > Debug console) and type the following command:
createmasternodekey
(This will be the masternode’s privkey. We’ll use this later…)

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 “Pay To:” field, the label will autopopulate 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)

5) Still on the main computer, we need to edit the masternode.conf. (Tools > Open Masternode Configuration File)
(or you can find the file in the PIVX data directory, by default in Windows it’ll be %Appdata%/PIVX or Linux ~)

Once you have the masternode.conf file open in a text editor, add the following line to it:

 <Name of Masternode(Use the name 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>

Example: MN1 31.14.135.27:51472 892WPpkqbr7sr6Si4fdsfssjjapuFzAXwETCrpPJubnrmU6aKzh c8f4965ea57a68d0e6dd384324dfd28cfbe0c801015b973e7331db8ce018716999 1

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

VPS Remote wallet install

7) Install the latest version of the PIVX wallet onto your masternode. The latest version can be found here: https://github.com/PIVX-Project/PIVX/releases

  1. Go to your home directory: cd ~
  2. From your home directory, download the latest version from the PIVX GitHub repository: wgethttps://github.com/PIVX-Project/PIVX/releases/download/v3.4.0/pivx-3.4.0-x86_64-linux-gnu.tar.gz
    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: https://github.com/PIVX-Project/PIVX/releases
  3. Unzip and extract:  tar -zxvf pivx-3.4.0-x86_64-linux-gnu.tar.gz
  4. Go to your PIVX 3.4.0 bin directory: cd ~/pivx-3.4.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.

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

9) 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
 rpcallowip=127.0.0.1
 server=1
 daemon=1
 logtimestamps=1
 maxconnections=256
 masternode=1
 externalip=your unique public ip address
 masternodeprivkey=Result of Step 1

Make sure to replace rpcuser and rpcpassword with your own.

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

Start your masternode

11) 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

12)Use the following command to check status:

./pivx-cli getmasternodestatus

You should see something like:

{
“txhash” : “334545645643534534324238908f36ff4456454dfffff51311”,
“outputidx” : 0,
“netaddr” : “45.11.111.111:51472”,
“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.