Masternode Setup Guide

Developer Guide Masternode and DEX APIs FAQ
Search…
This is a procedural step-by-step guide to setting up your first TomoChain Masternode using the tmn tool. It is meant for first-time and intermediate-level Masternode operators.
Security Disclaimer: Despite there being mention of some security elements in this guide, there is no implied guarantee of security. You alone must fully secure your server.
Technical Requirements / Recommendations
The following are required items and server specifications. Click here for more details​
50,000 TOMO deposit
Server (cloud-VPS or your-own)
16 vCPU cores (Prefer higher clock speed. Usually found on "CPU optimized" cloud providers' servers)
32GB RAM
Storage (Disk Space)
100 GB of storage for the base chaindata
~1 GB of weekly data storage space increase (reccomend SSD-based Block Storage; low-latency, not NAS speeds)
Note: These numbers may decrease with ongoing optimisations to the code base.
2 TomoChain wallets (addresses) - see details below​
Knowledge Requirements
VPS Setup - Ability to setup a cloud-hosted virtual private server (VPS)
Linux familiarity - A basic knowledge of how to SSH-into (ex: putty or terminal) and operate the Linux command-line.
Do not proceed if you are not confident with the Linux command-line. Why? The upkeep and troubleshooting will become more complex than this guide. Some commands fail and you must know what you are doing.
For Advanced users, go here (Command-line-only-version)
For advanced users or repeat-offenders, see this super-short command-line-only version of the lengthy guide below. If you have done this before or know what you are doing, you might more-easily follow these Linux commands instead of having to read through the lengthy prose below.
Note: You will MISS many tips and tricks found in the detailed instructions.
Beginner/Intermediate users, keep reading...
Introduction
What is a Masternode?
A Masternode is a computer on a decentralized blockchain network that is running 24 hours a day, and keeps the system operational. It powers the blockchain network by processing transactions and signing blocks.
What are the benefits of a Masternode?
Masternodes help support the network by creating and signing blocks, providing faster transaction times, and decentralized operations. They utilize PoS (Proof of Stake) vs PoW (Proof of Work) consensus-building. Masternode operators are paid a reward (tokens) as an incentive for their involved investment of token deposit, server setup, and continued operation.
What is a VPS?
VPS stands for Virtual Private Server. They are paid servers hosted on a cloud-hosting-provider. Each VPS runs an independent installation of an operating system (OS), Linux or Windows, and typically provides root access to the OS for advanced management and control.
Why is a VPS highly recommended for Masternodes?
A VPS is recommended (and often required) for Masternode setups, as you will need a dedicated static IP and 99.9% uptime to provide a stable and efficient node for the network. Unlike your home or office PC, a Masternode VPS serves one purpose, to securely and efficiently run a Masternode. A VPS is online 24/7 and provides dedicated resources for the project’s decentralized network.
1. Choose your hosting provider
Choose which VPS hosting provider you want to utilize.
The following providers are sample VPS providers. You could choose elsewhere, or even your own 24/7 server.
​AWS (Amazon)​
​DigitalOcean​
​GCE (Google)​
​Linode​
​OVH​
​Vultr​
Note on provider choice: It is encouraged for Masternode operators to utilize various hosting providers so as to encourage a more decentralized network. It is in your best interest because if any one popular provider goes down, others will get more rewards. 

2. Start your VPS server
Start/Boot your VPS server instance.
Choose Ubuntu 18.04. This is an LTS version (Long Term Support). LTS versions are more stable and have seen less errors when installing Docker and Python. You must use Ubuntu 18.04 to seek support from the wider community or TomoChain. If you need help with this, see this example.
Data Storage: It is recommended to assure that your provider has Block Storage or expandable disk space on SSD drives (greater performance). Block Storage is pay-as-you-go disk space that you can expand in the future. You may not need it now, but you will in the future. Some locations within a hosting provider do not have this, while others will.
SSH-Key login: Consider utilizing a SSH-Key login over passwords. Some providers allow you to set it up upon server creation. 

3. Change passwords and accounts (logged in as root user)
Login to your newly created server with SSH / Putty.
If you need help with this, see this example.
1
SSH [email protected]
Copied!
Note on Users: Login as the root user at first. Later, we will create and switch to your own username.
If you did not utilize SSH-key login (highly recommended), you will want to change the root password (only the first time) with the following command.
1
passwd
Copied!
Save your root password as you can get locked out of your own server if you forget it. It is strongly recommended to use a 16+ char password with a mix of letters, numbers, special characters.
You are now logged in as root. The root user is the administrative user in a Linux environment that has very broad privileges. Because of the heightened privileges of the root account, you are discouraged from using it on a regular basis. This is because part of the power inherent with the root account is the ability to make very destructive changes, even by accident.
The next step is to set up an alternative user account with a reduced scope of influence for day-to-day work.
Create a new user
Use the following command to add a new user account that we will use to log in to from now on. Our user is called Michael, you can replace it with any username that you like. Use the same username as your local mac/PC username and you will have an easier time logging in!
1
adduser michael
Copied!
You will be asked a few questions, starting with the account password. Enter a strong password. Optionally, fill in any of the additional information if you want or ignore it. This is not required and you can just hit ENTER in any field you wish to skip.
Grant the user administrative privileges
Now we have a new user account with regular account privileges. However, we will need to do administrative tasks from this normal account.
To add these privileges to our new user, we need to add the new user to the sudo group. This will allow our normal user to run commands with administrative privileges by putting the word sudobefore each command.
As root, run this command to add your new user to the sudo group (substitute Michael with your new user):
1
usermod -aG sudo michael
Copied!
-a stands for Append and -G is Group; sudo is the group name you are adding to your user
You can check to make sure that the usermod command worked:
1
cat /etc/group | grep sudo
2
groups michael
Copied!
Assure that you get a response such as sudo:x:27:michael from first command and michael : michael sudo from the second command. 
When you eventually (not yet) log in as your new user, you can type sudo before commands to perform actions with superuser privileges. Remain logged in as the root user for now, as we have more initial setup to do. After this, you will almost always login as your new user. 


4. Configure your VPS (remain logged in as root user)
We will now prepare the prerequisites for tmn. You need Python 3.6+ and Docker installed.
Upgrade operating system
We should upgrade the Ubuntu operating system and all installed package libraries first. You may consider doing this upgrade occasionally in the future. Type these two commands on the console with an ENTER after each:
1
apt update
2
apt upgrade
Copied!
Watch out for WARNINGs or ERRORs. A lot of text could fly by, and you should watch all of it in case something installs incorrectly. Google anything out of the ordinary and try to understand or fix it.
Reboot your VPS instance in case any of the upgraded components will only fully engage until rebooted fresh.
1
reboot
Copied!
Install Python
1
apt install python3
2
apt install python3-pip
Copied!
Check if you have installed the right Python version (must be newer than version 3.6).
1
python3 --version
Copied!
System Security
This topic is optional, but highly recommended. If the default SSH port is not changed, you could see nefarious connection-attempts in a short time-period.
​Look at our wiki security doc for more details​
At a minimum, you will want to consider:
SSHD on non-standard port
UFW (Uncomplicated Fire Wall) (open port 30303 tcp & udp, and above non-standard SSH)
Other security options you could consider:
SSH key-based login (vs password)
Fail2ban
Blocking remote password auth
Blocking remote root SSH-access 
5. Setup Docker (logged in as new user)
From now on, you will almost always want to login as your new user. If you are logged in as root still, logout and log back in as the new user. You may want to consider denying remote root SSH logins.
1
SSH [email protected]
Copied!
Install Docker Repositories
Update the apt package index. Then install various packages to allow apt to use a repository over HTTPS. The third line adds Docker’s official GPG key.
1
sudo apt update
2
sudo apt install apt-transport-https ca-certificates curl software-properties-common
3
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Copied!
"OK" is normal output of that last command; -fsS shows less progress, but still error messages and -L allows redirect
NOTE: Be careful with certain SSH consoles. They may not paste the ‘|’ symbol correctly.
Next, verify that you have the correct key, by searching for the last 8 characters of the fingerprint. Compare the results to what is below.
1
apt-key fingerprint 0EBFCD88
Copied!
Example Results (format may be slightly different, but the string of char-numbers the same):
1
pub   rsa4096 2017-02-22 [SCEA]
2
      9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
3
uid           [ unknown] Docker Release (CE deb) <[email protected]>
4
sub   rsa4096 2017-02-22 [S]
Copied!
Use the following command to set up the "stable" repository. You could get errors here if you have a release of Ubuntu that is too recent (non LSB).
1
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
Copied!
Install Docker CE
Update the apt package index. Then install the latest version of Docker CE:
1
sudo apt update
2
sudo apt install docker-ce
Copied!
Watch out for WARNINGs or ERRORs. Google anything out of the ordinary and try to understand or fix it.
Once installed, add your current user to the Docker group and verify that the user has been added.
1
sudo usermod -aG docker michael
2
groups michael
3
cat /etc/group | grep docker
Copied!
Assure Docker is working
Verify that Docker CE is installed correctly by running the hello-world image. This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits. The second command shows more detailed docker information.
1
docker run hello-world
2
sudo systemctl status docker  # hit 'q' to exit
Copied!
Docker CE is installed and running.
Congratulations! You have installed Python and Docker. You have the prerequisites ready to run TomoChains' tmn.
TROUBLESHOOTING
error: could not access the docker daemon
If you have installed Docker, and get this error, you probably forgot to add your user to the docker group. Please run this, close your session and open it again.
usermod -aG docker $(whoami)
6. Installing TMN utility
Tmn is a simple interface created by TomoChain developers to help you quick start your Masternode. It is installed as a python package and it utilizes two docker containers once operating. We will follow through the steps found here: guide to install tmn​
“We made a simple command line interface called tmn to easily and quickly start a TomoChain Masternode. It takes care of starting the necessary docker containers with the proper settings for you. It will really suit you if you don’t already have a big infrastructure running. Spin up a machine in your favorite cloud and get your Masternode running in a few minutes!”
Install and update the tomochain-created tmn utility from pip:
1
pip3 install --user tmn
2
pip3 install -U tmn
Copied!
Watch out for WARNINGs or ERRORs and troubleshoot (see end of this section).
To check that tmn has been correctly installed, use the following command to show some tmn info:
1
pip3 show tmn
2
​
3
Name: tmn
4
Version: 0.5
5
Summary: Quickstart your masternode
6
Home-page: https://tomochain.com
7
Author: Etienne Napoleone
8
Author-email: [email protected]
9
License: GPL-3.0+
10
Location: /home/michael/.local/lib/python3.6/site-packages
11
Requires: python-slugify, click, clint, pastel, docker
Copied!
The next step will be to actually START TMN, however we cannot do this until we have two wallet addresses. See the next section for this.
TROUBLESHOOTING
Occasionally a VPS image will not come installed with all of the software packages needed to install what we need. If you get any of the errors below, you are in need of particular packages to be installed.
1
ERROR:
2
ModuleNotFoundError: No module named ‘setuptools’
3
SOLUTION:
4
sudo apt-get install python3-setuptools
Copied!
1
ERROR:
2
Failed building wheel for <package>
3
SOLUTION:
4
pip3 install wheel
Copied!
1
ERROR:
2
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1
3
SOLUTION:
4
sudo apt install build-essential
Copied!
1
ERROR:
2
fatal error: Python.h: No such file or directory
3
SOLUTION:
4
sudo apt install python3-dev
Copied!
7. Create Wallet Addresses
Before being able to proceed further, you will need two separate TOMO wallet addresses to operate a Masternode. One helps to operate the Masternode day-to-day, and the other is where the 50,000 TOMO is staked from. The genius of this is that the wallet where the 50,000 TOMO will pass through (and where rewards will eventually come into) is never stored or seen by the VPS server. This is a security strategy that keeps your coins safe.
WALLET1 - Operating Wallet: Used for operating the Masternode, including signing blocks. It effectively acts as a unique identifier of your Masternode. No coins need to be inserted in this wallet; It's even advised to be empty, so in case of breach, no funds are exposed.
WALLET2 - Deposit Wallet: Your 50,000 of staked tokens need to be placed here; later, the 50,000 will go into a smart contract; eventually, Masternode rewards will show here.
You will need both the Public Key and Private Key for both addresses. It is advise that you store all of this information somewhere safe, yet accessible. You may need to utilize this information during continued operations of your Masternode. Password manager apps like KeePass/KeePassXC, LastPass, or 1Password are your friend. Your private key is your money. Give it to no one.
WALLET1 Suggestions - If setting up a single Masternode, you can use a mobile wallet. Binances Trust Wallet and TomoChains Tomo Wallet apps are best. Alternatives are Metamask and MEW (MyEtherWallet), in that order. You can use Ledger Hardware Wallet, however the added security on WALLET1 isn't as necessary.
WALLET2 Suggestions - Preferred to use Ledger / Hardware Wallet (if possible) in combo with Metamask because 50,000 and rewards will be handled here. Assure to use an address you do not have history on eth chain with - otherwise others will be able to see your unrelated investment history.
Because most wallet apps do not have TomoChain mainnet as a selectable network yet, you will need to manually add the new mainnet if you have not already. See the first link below for the guide on how to do this.
How to Set Up a Wallet:
​Setting Up MyEtherWallet, Metamask, or Binance TrustWallet​
More info:
​Using Metamask or Mobile TomoWallet​
​Old Masternode guide (testnet) Section on wallets 

8. Run TMN
Below, you will finally start your TomoChain node with a utility called tmn.
Initial TMN start
IMPORTANT: Logout and SSH back in so that the $PATH variable takes effect. This allows you to run tmn from any directory.
1
exit
2
ssh [email protected]
Copied!
When you first start your full node with tmn start, you need to give some information.
--name: The name of your full node. Your input will be converted to a "slugified" name. Slug format allows all letters and numbers, dashes ("-") and underscores ("_"). Ex: MyMaStErNode#24 cool -> mymasternode24-cool. You can name it to reflect your identity, company name, etc. 
--net: The network your full node will connect to. You can choose here to connect it to the TomoChain mainnet or testnet. 
--pkey: The private key of your WALLET1 wallet (non 50k). A TomoChain full node uses a wallet address to be uniquely identified and to receive transaction fees. Transaction fees are not rewards, and they are usually tiny. Important note: we advise for security measures to use a fresh new wallet for your Masternode. This is not the wallet that will receive the rewards. The rewards are sent to the wallet that will make the 50k TOMO initial deposit.
The command is structured like this:
1
tmn start --name [YOUR_NODE_NAME] --net mainnet --pkey [YOUR_WALLET1_PRIVATE_KEY]
Copied!
We used the following command for our node (copy your own name & private key):
1
tmn start --name Atlantis --net mainnet --pkey cf03cb58************
Copied!
TROUBLESHOOTING
tmn: command not found
It might happen that your PATH is not set by default to include the default user binary directory. You can add it by adding it to your shell $PATH:
On GNU/Linux:
1
echo "export PATH=$PATH:$HOME/.local/bin" >> $HOME/.bashrc
2
source $HOME/.bashrc
Copied!
9. Check sync status
This section coming soon.
Contents to come: tmn status; tmn inspect; top command; https://stats.tomochain.com/ website; # of blocks command; tmn update, tmn --help, etc 

10. Jumpstart the chaindata (Optional)
​Full Jumpstart instructions can be found here​
The basic structure has been created, blocks have started synchronizing, and now we want to speed up the process by pulling in the latest chaindata.
Chaindata is where the entire history of TomoChain blockchain records are stored. All coin transactions, all smart contracts, all operations. This takes up a lot of space. To synchronize it from decentralized nodes piecemeal-like could take days or weeks. Instead, lets download the latest image of the data, and synchronize from there.
11. Apply for Masternode Candidacy
This section coming soon. For now, see here​
Contents to come: Explain; Assure synced; master.tomo; login; apply 

12. Name your Masternode
This section coming soon.
Contents to come: https://master.tomochain.com/ ; login as 50k wallet; find your MN; edit; enter name; sign data 

13. Verify initial rewards
This section coming soon.
Contents to come: https://master.tomochain.com/ ; https://scan.tomochain.com/ ; explain infra vs stake reward; link to economics
APPENDIX
Commands-only (ADVANCED users)
If you have done this before or know what you are doing, you can follow these Linux commands.
Note: You will MISS many tips and tricks in the detailed instructions.
1
ssh [email protected]
2
passwd
3
​
4
adduser michael; usermod -aG sudo michael
5
groups michael
6
​
7
apt update; apt upgrade; reboot
8
​
9
apt install python3
10
apt install python3-pip
11
python3 --version
12
​
13
ssh [email protected]
14
sudo apt update; sudo apt install apt-transport-https ca-certificates curl software-properties-common
15
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
16
apt-key fingerprint 0EBFCD88
17
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
18
sudo apt update; sudo apt install docker-ce
19
sudo usermod -aG docker michael; groups michael
20
docker run hello-world
21
​
22
pip3 install --user tmn
23
pip3 install -U tmn
24
pip3 show tmn
25
​
26
# Create Wallet Addresses
27
​
28
# logoff ssh and back in to set $PATH variable
29
tmn start --name Atlantis --net mainnet --pkey cf03cb58************
30
tmn status; tmn inspect; tmn --help
31
​
32
# Enact Jumpstart: https://github.com/tomochain/docs/wiki/Update-stuck-node-or-Jumpstart-chain-sync
Copied!