About / Background

Many masternode crypto currencies only have incomplete or even non-existing instructions available how to setup a masternode from source.

This project started as handy bash script to setup my $PIVX masternodes in 2016 when there was almost zero documentation and anything that existed was either $DASH specific, sucked and in most cases both. For that reason, i started to work on a not-so-sucking way to install a lot of different masternodes with next to none manual intervention.

If you are not already aware, visit the project site and join the slack. The website at https://pivx.org/ is also well worth a visit.

Many people use binaries, end of with an insecure configuration or fail completely. This is obviously bad for the stability of the individual network.

After doing hundreds of masternode installations in the past two years, i decided to share some of my existing auto-install and management scripts with the community to work on a generalised & reliable setup for all masternode coins.

Comparing with building from source manually, you will benefit from using this script in the following way(s):

100% auto-compilation and 99% of configuration on the masternode side of things. It is currently only tested on a vultr VPS but should work almost anywhere where IPv6 addresses are available

Developed with recent Ubuntu versions in mind, currently only 16.04 is supported

Installs 1-100 (or more!) masternodes in parallel on one machine, with individual config and data

Compilation is currently from source for the desired git repo tag (configurable via config files)
Some security hardening is done, including firewalling and a separate user

Automatic startup for all masternode daemons

This script needs to run as root, the masternodes will and should not!

It's ipv6 enabled, tor/onion will follow

Installation

SSH to your VPS and clone the Github repository:

git clone https://github.com/masternodes/vps.git &&cd vps

Install & configure your desired master node with options:

./install.sh -p pivx

Examples for typical script invocation

These are only a couple of examples for typical setups. Check my [easy step-by-step guide for vultr that will guide you through the hardest parts.

Install & configure 4 PIVX masternodes:

./install.sh -p pivx -c 4

Update daemon of previously installed PIVX masternodes:

./install.sh -p pivx -u

Install 6 PIVX masternodes with the git release tag "tags/v3.0.5.1"

./install.sh -p pivx -c 6 -r "tags/v3.0.5.1"

Wipe all PIVX masternode data:

./install.sh -p pivx -w

Install 2 PIVX masternodes and configure sentinel monitoring:

./install.sh -p pivx -c 2 -s

Options

The install.sh script support the following parameters:

Long Option

Short Option

Values

description

--project

-p

project, e.g. "pix"

shortname for the project

--net

-n

"4" / "6"

ip type for masternode. (ipv)6 is default

--release

-r

e.g. "tags/v3.0.4"

a specific git tag/branch, defaults to latest tested

--count

-c

number

amount of masternodes to be configured

--update

-u

--

update specified masternode daemon, combine with -p flag

--sentinel

-s

--

install and configure sentinel for node monitoring

--wipe

-w

--

uninstall & wipe all related master node data, combine with -p flag

--help

-h

--

print help info

--startnodes

-x

--

starts masternode(s) after installation

Troubleshooting the masternode on the VPS

If you want to check the status of your masternode, the best way is currently running the cli e.g. for $MUE via