Installation Guide

This guide will help you to create, register, and host your masternode on a VPS.
*** This guide was fully tested under Debian 12 ***

You need to have some knowledges about linux and ssh connexion.

You need to have this:

 - A working and sync wallet.
 - The correct amount of collateral for the coin you want to make a masternode.
 - Eventually, a beer or a coffee +_+
 - And of course a VPS ^^

Editing the masternode configuration file

We need to edit the masternode configuration file.

You can edit the conf file by sftp, scp or by typing this:

nano ???


				Select all text below, copy it, and if you use nano editor in putty, just right click in the window to paste it.
				rpcuser=ae24bfb568e65b08u
rpcpassword=ae24bfb568e65b08p
rpcbind=0.0.0.0
rpcallowip=127.0.0.1
listen=1
server=1
daemon=1
maxconnections=125
masternode=1
masternodeblsprivkey=???
externalip=???

				Once done, press {CTRL-O} to save the file and {CTRL-X} to exit the editor (or use your favorite editor).



		
			Run the daemon 👹
			
				Now, we will launch the daemon, and if you did all correctly, it should runs fine.
				???
				You should see a message indicating the daemon is starting.
				Wait ~30 seconds and go to next step.
			
			
				
				
			
		
		
		
			Checking the blockchain sync
			
				We need to verify if the blockchain is syncing.
				??? getblockchaininfo | grep -E '"blocks"|"headers"' | awk -F': ' '{print $2}' | tr -d ','
				You should have an output with 2 numbers. The first is the current sync block. The second is the blochain heigh. They should be the same and the last (look at explorer or in a wallet to see the last block heigh).
				While it's syncing, we will register your masternode on the blockchain.
			
			
				
				
			
		
		
		
			Unlock the wallet
			
				Go back to your wallet debug console, if you wallet is not password protected, go to next step, if yes, we need to unlock it:
				walletpassphrase "your_walletphrase" 600 
				Of course, replace 'your_walletphrase' by your wallet password 😂
Wallet is now unlocked for 600 seconds, which will give us time to send the protx command to register your masternode. Go to next step.
			
			
				
				
			
		
		
		
			Register the masternode
			
				We need to send a PROTX command to register the masternode on the blockchain. Send this command (all text block) in the wallet console:
				NO COMMAND
				If you have done all correctly, this will return a tx hash like this: 724b0ab086c759fc7bc664a149a7ba6b82dacd47e69799720eb3e591e096cb6c
				
					Paste this tx hash here:
					
				
			
			
				
				
			
		

		
			Waiting for masternode ready
			
				Go back to your SSH console, with the opened container under the 'crypto' user. We will check the masternode state. Type this:
				??? masternode status
				You should see a "READY" state at the end of the returned value.
				If you see POSE BANNED; you need to revive the node (command available at the end of this guide).
				If you see "WAITING FOR PROTX" you need to wait until your protx command get 2 blocks confirmation minium.
				Keep repeating this command every one or two minutes until you see "READY" state.
				The, we can go to next step.
			
			
				
				
			
		
		
		
			Exiting the container
			
				Now, we will modify the container, to make it boot with the start.sh script.
				This script will auto-launch the daemon at the container start.
				It will automatically check if the daemon did not crashed every 30 seconds.
				If it's the case, it will relaunch it. But for now we need to stop the daemon and exit the container.
				Type this in the ssh console:
				{CLI} stop
				And now:
				exit
				And one more time:
				exit
				You should be now under your first user, out of the container:
				{USER}@******:~$
			
			
				
				
			
		
		
		
			Start the container with the script
			
				We need to stop the container to modify the entry point (the start.sh script):
				docker container stop {CONTAINER_NAME}_tmp
				Wait ~10 seconds for the container to stop.
				Now, type this:
				docker commit --change='ENTRYPOINT ["/home/crypto/start.sh"]' {CONTAINER_NAME}_tmp {CONTAINER_NAME}
				We have now a clone of our container, with the same disk volume, and starting with the start.sh script.
				We can start this new container with command block text:
				docker run -dit --name {CONTAINER_NAME} -p {PORT}:{PORT} -v {CONTAINER_NAME}_vol:/home/ --restart unless-stopped {CONTAINER_NAME}
			
			
				
				
			
		
		
		
			Verifying all is OK
			
				We will now enter the new container to check if all runs good.
				docker exec -ti {CONTAINER_NAME} bash
				And use the correct username:
				su - crypto
				Now, we check if masternode is ok:
				{CLI} masternode status
				You should see "READY". If not the case, you need to wait if you have "WAIT FOR PROTX" or revive it if you have "POSED BANNED"; with protx update_service command (see later).
				Now, we will clean a little your disk 😉
			
			
				
				
			
		
		
		
			Cleaning the disk
			
				We will exit from the container, like earlier:
				exit
				And again:
				exit
				To clean files and container we do not use anymore, type this:
				docker container rm {CONTAINER_NAME}_tmp
				The temp container is now erased.
				Now, you will have some command you need to keep to manage your masternode.
			
			
				
				
			
		
		
		
			Commands to manage you masternode
			
				For all this commands, you need to have funds in the fees address you have chosen !
Screen this page or copy-paste it all !
				Command to revive a POSED BANNED masternode:
				{COMMAND}
				Command to change reward address, the owner key of the masternode must be known to your wallet:
				{COMMAND}
				Change masternode IP:
				{COMMAND}
				Little text reminder:
				Collateral address: {COLLADDR}
Owner address: {OWNADDR}
Voting address: {VOTADDR}
Fee address: {FEEADDR}
Reward address: {REWADDR}
PROTX Hash: {PROTXHASH}
BLS Private Key: {BLSPRVKEY}
BLS Public Key: {BLSPUBKEY}
Masternode IP: {IP}
Masternode PORT: {PORT}

			
		
		
		
			xxxxxxxxxxxxx
			
				xxxxxxxxxxxxx
				xxxxxxxxxxxxx
				xxxxxxxxxxxxx
				xxxxxxxxxxxxx
				xxxxxxx
			
			
		
















		
			xxxxxxxxxxxxx
			
				xxxxxxxxxxxxx
				xxxxxxxxxxxxx
				xxxxxxxxxxxxx
				xxxxxxxxxxxxx
				xxxxxxx

Installation Guide

Select crypto coin

Creating addresses

Sending coins for collateral

Creating a BLS key

Installing the VPS

Creating and updating user - Part 1

Creating and updating user - Part 2

Docker Container Config

Creating the container

Updating and installing required components and libraries

Download node files & bootstrap

Editing the masternode configuration file

Run the daemon 👹

Checking the blockchain sync

Unlock the wallet

Register the masternode

Waiting for masternode ready

Exiting the container

Start the container with the script

Verifying all is OK

Cleaning the disk

Commands to manage you masternode

xxxxxxxxxxxxx

xxxxxxxxxxxxx