Veriscope Installation Guide

veriscope architecture

Veriscope Installation

The Veriscope GitHub repo comes with a complete installer/set-up script which installs the following components and also sets-up an admin user for your Veriscope web application:

  1. Dependencies & pre-requisites, e.g. npm and PostgreSQL

  2. A Nethermind Node (client responsible for synchronizing the Shyft Network blockchain)

  3. A Nginx web-server (serving SSL connections with a reverse-proxy to backend services running NodeJS and PHP Artisan)

  4. A NodeJS web service

  5. A Laravel/PHP Web Application

  6. Redis to manage/post attestations

  7. Horizon dashboard to monitor Redis queues (a view is included in the Veriscope web-app)

To install Veriscope using the set-up script, you first need to provision a machine/server that:

  1. Is reachable over the internet on ports 80 and 443

  2. Has a DNS name that points to it (e.g. subdomain.domain.com)

It is recommended to use Ubuntu 20.04 with the following hardware, at a minimum:

  • 8+ GiB of RAM

  • 2x CPU cores

  • 32 GB

Once Veriscope is installed, run the following to check that ports are as expected:

sudo apt install net-tools
sudo netstat -tulpn

The following information will be generated during the installation process and will be required in subsequent steps. It is important this information is stored & shared securely.

  1. Node http url (i.e. VERISCOPE_SERVICE_HOST=subdomain.domain.com)

  2. Trust anchor account public/private key pair

  3. Trust anchor dashboard login credentials. The Veriscope web-app will be hosted at the node http url above once the node installation is complete.

Active testnet nodes can be viewed at fedstats.veriscope.network