[Unofficial][Newbie Friendly] Masternode Guide


This will be an re-organization of @s3v3nh4cks guide to setup masternodes.


First the basic requirements:
-10,000 PIV
-A main computer(Your everyday computer browsin’, game playing’ computer)
-Masternode Server(The computer that will be on 24/7)
-A unique IP address for EACH masternode
(For security reasons, you’re gonna 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. These inscructions will be made for hosting 2 masternodes, but
with a little common sense, you can expand these ideas for as many as you want!

For this guide, I’m going to refer to your main computer’s wallet as the main wallet, and the masternode(s) wallet as the masternode wallets.
I will also be simulating the install using a Ubuntu server using the command line. If your using pivxd, all commands should be proceeded by ./pivx-cli .

  1. Using the main wallet, enter the debug console and type the following command twice:
    masternode genkey (This will be the masternode’s privkey. We’ll use this later…)
    (If you’re only setting up one masternode, this will only be used once.)

  2. Using the main wallet still, enter the following command twice:
    getaccountaddress chooseAnameforyournode

  3. Still in the main wallet, send 10,000 PIV to (both) adresses. Make sure this is 100% only 10,000; No less, no more.

  4. Still in the main wallet, enter the command into the console:
    masternode outputs (This gets the proof of transaction of sending 10,000)

  5. Still on the main computer, go into the PIVX data directory, defualty in Windows it’ll be %Appdata%/PIVX.
    Find masternode.conf and add the following line(s) to it:

     USAGE:  <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>

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

  1. Still on the main computer, open the pivx.conf file (Find it or use the edit the config file in the PIVX-qt client under “Tools”). Make it look like this:
    > rpcuser=long random username
                 rpcpassword=longer random password

Save it, close and restart the wallet.

  1. Now on one of the masternodes, find the PIVX data directory here.(Linux: ~/.pivx). Open the pivx.conf file and make it look like this:
    > rpcuser=long random username
                 rpcpassword=longer random password
                 externalip=your unique public ip address
                 bind=your unique public ip address
                 masternodeaddr=your unique public ip address
                 masternodeprivkey=Result of Step 1

Make sure to replace rpcuser and rpcpassword with your own.

  1. Close and restart this masternode wallet.

  2. Repeat steps 5 and 6 for each masternode you need.

  3. Now, you need to finally start these things. Use the appropiate commands:
    If you have 1 masternode: masternode start-alias alias (Make sure wallet is unlocked)
    2+ Masternodes: masternode start-many

If you did it right, you should see something like this:

                       "overall" : "Successfully started 2 masternodes, failed to start 0, total 2",
                       "detail" : {
                          "status" : {
                             "alias" : "mn1",
                             "result" : "successful"
                          "status" : {
                             "alias" : "mn2",
                             "result" : "successful"



How do I know if its working?

Use the following command to check status:
masternode status

You should see something like:
“vin” : “CTxIn(COutPoint(masternode output, index
), scriptSig=)”,
“service” : “ip:51472”,
“pubkey” : “masternode address”,
“status” : “Masternode successfully started”

If not keep reading.

Once enabled, you should see it start to see the time online increase, if not, its probably not up.


- Your masternode’s wallet isn’t synced.
Run the command getinfo (./pivx-cli getinfo)
Look at the block number, it should be or close to the “Last Block” @

    Add the following lines to your pivx.conf:

Also try deleting the folders: blocks, chainstate and database. And redownload them or use this: https://www.dropbox.com/s/vhmo42g7ik3jgf3/_Chain-Backup-535500.zip?dl=0
- Masternode runs then goes missing
You might be hitting resource limits.
Try checking available memory and confirming you have atleast 1gb free(Linux VPS based).


If you need anymore help find me @slimjim on the forum or slack, and I’ll do my best to assist. Theres also many other helping hands out there. Credit to @s3v3nh4cks for the original guide.

Thanks @s3v3nh4cks for helping me and allowing me to help others



Great tutorial :slight_smile:


Do I need one computer for each masternode?


If you can figure out how to have multiple IPs to run at the same time in one computer then sure, otherwise you would need separate IPs for each MN.


A unique IP Address per MN


does this apply when setting it up in windows enviroment as well? ty


Hi Slimjim, just used the guide to setup a MN using raspberry pi. Question on IP address, it is my understanding that the IP address in my pivx.conf file on my server (raspberry pi) should be the same IP address that I reference in my masternode.conf file on my main computer. It is also my understanding that this should be my external IP address. So here’s my question. Do I not have more that one external IP address? One for my main computer and one for my server (raspberry pi)? And if so, which one should I be using? I hope you understand my question. Thank you.


Your external IP can be explained as, the ip to the ‘world’. Each computer on your network has its own, ‘local IP’. Meaning it’ll be like, 192.168.x.x but a external ip would be x.x.x.x… websites like cmyip.com can help you find your external ip, whereas running ifconfig on linux or ipconfig on windows will show a local ip. @slimjim on slack


That is awesome explanation SJ. One follow up however, which external IP should I be using in my pivx.conf file and my masternode.conf file? The external one for my raspberry pi server or my main computer? Thanks!


Anyplace you put an IP should be your ‘External IP’, you will also need to portforward port: 51472 tcp using your PI’s local IP. I could explain this forever if needed.


Slimjim, the mystery continues. By the way thanks for your willingness to share and your patience. I think I understand what you’re now saying, however, in multiple examples people have said to use the same external IP in both places (Raspberry Pi) and my main PC. Doesn’t make sense. Thanks,


Dm’d you on slack

randomlettersso i can post a small message


I asked my ISP for multiples public IPs but they don’t provide them, tried to a VPN service and just the same. Does anyone from Brazil know how to obtain dedicated IPs?


I use a 1 euro a month vps, my masternode pays it in literally 1/4 of 1 payment


Thanks so far guys! I am in the way to hire a VPS. But, would someone tell me the minimum requirements to run the Masternode?
I also have a intriguing question: Once the Masternode is set is it possible to stake with using the same coins?


in step 3 when you say send 10,000PIV to both addresses that means 10,000 each right? So if we followed your steps we would need 20,000PIV?


Pretty sure he said the tutorial is to set 2 masternodes, meaning that you are right, for two you will need 20.000 PIVX.


Please folks don’t forget my previous post:

Thanks so far guys! I am in the way to hire a VPS. But, would someone tell me the minimum requirements to run the Masternode?
I also have a intriguing question: Once the Masternode is set is it possible to stake with using the same coins?


Typically, atleast 1GB ram, decent hdd space. No you cannot stake with mn coins


hi, thanks for this very good guide.
i have 1 problem:
step 4, masternode outputs,
after having sended exactly 10 PIVX, and a lot of confirmations,“masternode outputs” gives no output, just brackets with no content. I have new 2.2.0 installed.
i use win7, prof, 64bit
thx for your help,