Setting up a Witness Node

This is an introduction for new Witnesses to get up to speed on the Peerplays blockchain. It is intended for Witnesses planning to join a live, already deployed, blockchain.

The following repository should be used in support of this document:

System Requirements

The following table lists what should be considered the minimum system requirements for running a witness node:






8 Cores




Ubuntu 18.04

These requirements are as of the time of writing, so consider deploying a server with specs slightly higher than the ones listed above in order to "future proof" your server in case the minimum requirements grow in the future.

Building on Ubuntu 18.04 LTS and Installation Instructions

The following dependencies are necessary for a clean install of Ubuntu 18.04 LTS:

sudo apt-get update
sudo apt-get -y install autoconf bash build-essential ca-certificates cmake \
dnsutils doxygen git graphviz libbz2-dev libcurl4-openssl-dev \
libncurses-dev libreadline-dev libssl-dev libtool libzmq3-dev \
locales ntp pkg-config wget autotools-dev libicu-dev python-dev

Build Boost 1.67.0

mkdir $HOME/src
cd $HOME/src
export BOOST_ROOT=$HOME/src/boost_1_67_0
sudo apt-get update
sudo apt-get install -y autotools-dev build-essential libbz2-dev libicu-dev python-dev
wget -c ''\
-O boost_1_67_0.tar.bz2
tar xjf boost_1_67_0.tar.bz2
cd boost_1_67_0/
./ "--prefix=$BOOST_ROOT"
./b2 install

Building Peerplays

cd $HOME/src
export BOOST_ROOT=$HOME/src/boost_1_67_0
git clone
cd peerplays
git checkout master # --> replace with most recent tag
git submodule update --init --recursive
git submodule sync --recursive
make -j$(nproc)
make install # this can install the executable files under /usr/local

Note: #master# can be replaced with the most recent release tag.

Starting the Peerplays Witness Node

If we have installed the blockchain following the above steps, the node can be started as follows:

# If you need the logs, the following can be helpful
# witness_node 2>&1 peerplays.log

Install Docker Image

This Docker image can be installed as an alternative to the previous steps. It doesn't need to be run if those steps have already been completed.

# Install docker
sudo apt install
# Add current user to docker group
sudo usermod -a -G docker $USER
# You need to restart your shell session, to apply group membership
# Type 'groups' to verify that you are a member of a docker group
# Build docker image (from the project root, must be a docker group member)
docker build -t peerplays .
# Start docker image
docker start peerplays
# Exposed ports
# # rpc service:
# EXPOSE 8090
# # p2p service:
# EXPOSE 1776

Build Graphene

Note: This step can be skipped if you're not running Ubuntu 14 - which really you shouldn't be!

cd ..
git clone
cd graphene
git submodule update --init --recursive

Starting A Peerplays Witness Node

git clone
cd peerplays
git submodule update --init --recursive

Launching the Witness creates the required directories.

Important: Next stop the Witness node before continuing.

$ vi witness_node_data_dir/config.ini
p2p-endpoint =
rpc-endpoint =
seed-node =

Start the Witness node back up.


Starting the witness as a service

We can add the peerplays blockchain node as a service using the following steps.

under, /etc/systemd/system create a file with the following content.


Upgrading A Peerplays Witness Node

To minimize downtime of your Peerplays Witness node when upgrading, it's recommended to create a backup Witness server.

CLI Wallet Setup

The next step is to set up the CLI Wallet.

Auto-Starting the Witness Node

It's important for your Witness node to start when your system boots up. The filepaths here assume that you installed your witness into /home/ubuntu/peerplays

Step 1. Create a log file to hold your stdout/err logging

sudo touch /var/log/peerplays.log

Step 2. Save this file in your Peerplays directory. vi /home/ubuntu/peerplays/

cd /home/ubuntu/peerplays
./programs/witness_node/witness_node &> /var/log/peerplays.log

Step 3. Make it executable

chmod 744 /home/ubuntu/peerplays/

Step 4. Create this file: sudo vi /etc/systemd/system/peerplays.service

Note: Check the path for, if necessary, change it to match where your file actually is.

Description=Peerplays Witness
WantedBy =

Step 5. Enable the service

sudo systemctl enable peerplays.service

Important: Make sure you don't get any errors.

sudo systemctl status peerplays.service

Step 6. Stop your Witness node, if it's currently running, then start it with the service.

sudo systemctl start peerplays.service

Step 7. Check your logfile for entries

tail -f /var/log/peerplays.log

BOS and MINT Setup

All Witnesses are also required to install and run the Bookie Oracle Suite (BOS) and the supporting manual intervention tool (MINT).