Polis - Create a Masternode


Setup a Masternode with Ubuntu 16.04 VPS

In this guide, you will learn how to prepare a Polis Masternode in Ubuntu version 16.04 VPS. Before you start, you need to meet the initial requirements.

This guide was done with the following environment:

  • Local: Windows 8.1 64 bit.
  • Remote: Ubuntu 16.04 64 bit (fresh Ubuntu server without Polis already installed).
  • Polis Version: 1.2.2.

Initial requirements

Virtual Private Server (VPS)

A Masternode must be hosted on a VPS. Get a VPS from a provider like DigitalOcean, Vultr, Linode, etc.

The recommended requirements for the master node would be the following:

  • Operating system (OS): Linux.
  • Linux Distribution: Ubuntu.
  • Version: 16.04 (Xenial) 64 bit.
  • Memory RAM: At least 1 GB RAM.
  • Disk Size: At least 30 GB.

POLIS Transaction

In order to have a Polis masternode, you must have a transaction of 1,000 POLIS in your desktop Cold Wallet.

To carry this out you need to open your Polis Core Wallet.

Now you will have to go to the “File” tab and select “Receiving Addresses…”.

Click on the “New” button and write a label for your new address (for example, “mn01”).

Right click on the address you just created and click on “Copy Address” and click on the “Close” button.

Now that you have the address created, you will send 1,000 POLIS to your address. With this, you will have a transaction of 1,000 POLIS in your wallet.

Click on the “Send” tab and on “Pay To”, enter the address you just created. You will see that in “Label” the name that you put before will appear.

Then you must enter the value of “1000” in “Amount” and you must NOT select “Substract fee from amount”. Finally, you must click on the “Send” button.

In the “Overview” tab, a “Payment to yourself” will appear. This transaction must be confirmed by the network, so you will have to wait for it to be confirmed (it may take five minutes of waiting depending on the state of the network and the commission chosen).

Cold Wallet Setup Part 1

Enabling Polis Core wallet advanced options

Open your Polis Core wallet on your desktop and now click on “Settings” tab, press on “Options…” and select “Wallet” tab.

The options that you have to select are the following:

  • “Enable coin control features”.
  • “Show Masternodes Tab”.

In the image you will see the two options that you will have to select.

Press “OK” button. In order to enable the new options, you have to restart Polis Core wallet.

Creating Masternode private key

Open your Polis Core wallet on your desktop and now click on “Tools” tab and press on “Debug console”.

Now you have to enter the following command:

masternode genkey

You should see a long key that looks like:


This is your Masternode private key. Keep it safe and do not share with anyone.

VPS Setup

VPS Connection

Depending on your local machine, you will need to use different steps:

  • Windows users: You have to connect using PuTTY and it is recommended to follow this guide.
  • Linux users: You have to connect using ssh.

Masternode Installation

Copy and paste these commands into your VPS and hit enter. Remember that one box at a time:

apt-get -y update
apt-get -y upgrade

Secure your VPS

Install Fail2ban:

apt-get -y install fail2ban
service fail2ban restart

Install dependencies and Polis Daemon

apt-get -y install software-properties-common
apt-add-repository -y ppa:bitcoin/bitcoin
apt-get -y update
apt-get -y install \
    wget \
    git \
    unzip \
    libevent-dev \
    libboost-dev \
    libboost-chrono-dev \
    libboost-filesystem-dev \
    libboost-program-options-dev \
    libboost-system-dev \
    libboost-test-dev \
    libboost-thread-dev \
    libminiupnpc-dev \
    build-essential \
    libtool \
    autotools-dev \
    automake \
    pkg-config \
    libssl-dev \
    libevent-dev \
    bsdmainutils \
    libzmq3-dev \
apt-get -y update
apt-get -y upgrade
apt-get -y install libdb4.8-dev
apt-get -y install libdb4.8++-dev
wget https://github.com/polispay/polis/releases/download/v1.2.2/poliscore-1.2.2-linux64.tar.gz
tar -xvf poliscore-1.2.2-linux64.tar.gz
rm poliscore-1.2.2-linux64.tar.gz
cp poliscore-1.2.2/bin/polis{d,-cli} /usr/local/bin
mkdir -p .poliscore
nano .poliscore/polis.conf



With your info!


CTRL X to save it. Y for yes, then ENTER.

Create Polis Service

Now you have to create Polisd Service:

nano /etc/systemd/system/polisd.service

With following info:

ExecStart=/usr/local/bin/polisd -conf=/root/.poliscore/polis.conf -datadir=/root/.poliscore
ExecStop=/usr/local/bin/polis-cli -conf=/root/.poliscore/polis.conf -datadir=/root/.poliscore stop

CTRL X to save it. Y for yes, then ENTER.

systemctl enable polisd
systemctl start polisd

Installing Sentinel

apt-get -y install virtualenv python-pip
git clone https://github.com/polispay/sentinel /sentinel
cd /sentinel
virtualenv venv
. venv/bin/activate
pip install -r requirements.txt
crontab -e

Hit 2. This will bring up an editor. Paste the following in it at the bottom.

* * * * * cd /sentinel && ./venv/bin/python bin/sentinel.py >/dev/null 2>&1

CTRL X to save it. Y for yes, then ENTER.

Use watch polis-cli getinfo to check and wait until it’s synced (look for blocks number and compare with a block explorer).

Cold Wallet Setup Part 2

  1. On your local machine open your masternode.conf file.
    Depending on your operating system you will find it in:

    • Windows: %APPDATA%\polisCore\
    • Mac OS: ~/Library/Application Support/polisCore/
    • Unix/Linux: ~/.poliscore/

    Leave the file open

  2. Go to “Tools” -> “Debug console”

  3. Run the following command: masternode outputs

  4. You should see output like the following if you have a transaction with exactly 1000 POLIS:

    "12345678xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx": "0"
  1. The value on the left is your txid and the right is the vout.
  2. Add a line to the bottom of the already opened masternode.conf file using the IP of your VPS (with port 24126), private key, txid and vout:
mn1 3xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 12345678xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 0
  1. Save the file, exit your wallet and reopen your wallet.
  2. Go to the “Masternodes” tab.
  3. Click “Start All”.
  4. You will see “WATCHDOG_EXPIRED”. Just wait few minutes.

Congratulations! You have just owned a Polis Master Node. A master node helps improve the network and provide the network with certain anonymous and fast payments functions, also including governance functions.

How can I check my masternode is working?

Assuming you are using the hot/cold wallet as recommended in our guides, check the following:

  1. On Windows/Mac wallet masternode tab
    The status field is ENABLED and the Active field is greater than 0:00.

  2. In Windows/Mac wallet debug console
    Type masternode list-conf and ensure everything looks correct, particularly that “status” : “ENABLED”.

  3. On linux vps (via PuTTY)
    Type polis-cli masternode status and look for “message” : “Masternode successfully started”.

  4. Check Masternode list
    Search for your masternode by IP Address or wallet address. Ensure that:
    a. Port shows as 24126 as is green. Red means you need to port forward and/or create a firewall rule. White means wait a while!
    b. Status is ENABLED.
    c. Daemon Version is 1.2.2.
    d. Active Time is > 0 and increases over time.
    e. Last Seen is less than 1 hour.

If all these checks are successful, your masternode is working correctly. You may have to wait over 40 hours for your FIRST reward.

Future improvements

  • Create a masternode user (move Polis files to user home).
  • Masternode user should launch Polis service and cron job (and not root user).
  • Create swap to improve OS performance.
  • Increase security with UFW (Uncomplicated Firewall).