How to setup Geekcash masternode

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

The basic requirements:

  • 100,000 GEEK (Get GeekCash)

  • A main computer (PC) — This will run the control wallet, hold your collateral 100,000 GEEK and can be turned on and off without affecting the masternode.

  • Masternode Server (VPS or PC that will be on 24/7)

  • Static IP address for your VPS / PC ( IPv4 only, IPv6 not yet support) that normally come with vps

(For difference MN, you’re are going to need a different IP for each masternode you host)

The basic reasoning for these requirements is that, you get to keep your GEEK in your local wallet and host your masternode remotely, securely.


#Create and send require coin

Step 1: Open your wallet select Receive tab, enter your label and click “Request payment” button


Step 2: Send exactly 100,000 Geek to masternode address you just created in step 1.

Step 3: Check Transaction status and wait until transaction validated success

#Configure masternode file

Get Private Key and collateral output txid

Step 1: Open debug console windows

and type:

masternode genkey : to get private key


masternode outputs : to get transaction id and index

It look like this:

“2bcd3c84c84f87eaa86e4e56834c92927a07f9e18718810b92e0d0324456a67c 0”

Step 2: Select tools – > Open Masternode Configure File

And create a line with this format:

alias IP:port masternodeprivkey collateral_output_txid collateral_output_index

  • alias : is name of masternode ( label of address)

  • ip:port : a static ip of your vps ( ipv4 only) and geekcash port 6889

  • masternodeprivkey : 93HaYBVUCYjEMeeH1Y4sBGLALQZE1Yc1K64xiqgX37tGBDQL8Xg

( masternode genkey)

  • collateral_output_txid:

2bcd3c84c84f87eaa86e4e56834c92927a07f9e18718810b92e0d0324456a67c ( masternode outputs)

  • collateral_output_index: it should be display “0” or “1” at then end after collateral_output_txid

Step 3: Save file and close the wallet.

Install geekcash on vps/pc

1. Open your vps over SSH by using putty or any tools

Step 1 : Type or paste this line below


Step 2 : chmod +x ./

Step 3 : bash ./

You have to enter private key in this step to go through.

2. Check the “current number of block”

geekcash-cli getinfo : to see all the information like version, block number etc…

Setup Sentinel

1. Install Prerequisites

Make sure Python version 2.7.x or above is installed:

python –version
python3 -v

If not run this command

sudo apt install -y python3-pip

Update system packages and ensure virtualenv is installed:

$ sudo apt-get update

$ sudo apt-get -y install python-virtualenv

Make sure the local GeekCash daemon running is at least version (1000102)

$ geekcash-cli getinfo | grep version

2. Install Sentinel

Clone the Sentinel repo and install Python dependencies.

$ git clone && cd sentinel

$ virtualenv ./venv

$ ./venv/bin/pip install -r requirements.txt

3. Set up Crontab

Set up a crontab entry to call Sentinel every minute:

$ crontab –e

In the crontab editor, add the lines below, replacing ‘/home/YOURUSERNAME/sentinel’ to the path where you cloned sentinel to:

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

4. Test the sentinel

Before run command below your masternode should be start first otherwise you will get this message " Invalid Masternode Status, cannot continue"

$ venv/bin/python bin/

should return nothing but silence. This is how you know it’s working.

With all tests passing and crontab setup, Sentinel will stay in sync with geekcashd and the installation is complete


An alternative (non-default) path to the geekcash.conf file can be specified in sentinel.conf:


Note: If you do not setup or configure this step, you may hit this kind of status for masternode: “SENTINEL_PING_EXPIRED”. So for your safety to get reward please do it

# Start masternode

Step 1: open your wallet

Select Settings – > Options – > Wallet tab – > select show masternode tab – > OK

Step 2: On Masternodes tab

Select the masternode want to start then hit “start alias” for that masternode or if only one hit “start all”

Then the message will be display :

“Successfully started 1 masternodes, failed to start 0, total 1”

Your master status will be PRE_ENABLED

Depend on network it may take 30 minutes or several hours to change to “ENABLED".

So leave it for some time.

In case you want to make sure everything is correct then open putty SSH to vps execute this command:

$ geekcash-cli masternode status

If you see something like this:

“status”: “Masternode successfully started”

Then go to take a cup of coffee and relax :slight_smile:

Masternode status you may have to know:

  1. ENABLED: That’s good status
  2. PRE_ENABLED: This status indicate that you just start your MN, you have to wait around 30 minutes
  3. SENTINEL_PING_EXPIRED: This status indicate that you did not install Sentinel or Sentinel did not start properly. Check back the steps above
  4. NEW_START_REQUIRED: This status indicate that your wallet has not fully synched the masternode list.It would always self correct by keeping the wallet open for a few hours. If not please click Start alias