Run a POA node on Windows

How to run a POA node on Windows

1. Install .Net

Catalyst.Node works with .Net Core v3.0. You'll need to have the .Net SDK installed.

If you don't have .Net Core installed you can follow the instructions for your platform bellow.

• Windows

2. Install the Rust Toolchain

Catalyst.Core uses our native Rust BulletProof library. In order to be able to build the solution, you will need to ensure that the Rust toolchain is correctly installed on you machine.

Windows environments

If you have not done so before, download and install the Microsoft Visual C++ Build Tools 2019 from https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019. Alternatively, if you are using Visual Studio, you should be able to modify your existing installation to add this feature.

Go to https://www.rust-lang.org/tools/install, then download and execute rustup-init.exe

Then

Nightly mode must now be installed and enabled by:

rustup toolchain install nightly

and then:

rustup default nightly

3. Install MongoDB

Instructions to install MongoDB can be found here for each operating system.

4. Clone the repository

To clone the repository it is assumed you have Git installed. If you do not, then follow the Git install instructions.

Prerequisite - Enable long paths

make sure that long paths are allowed in both windows and git

• for windows follow the instructions at https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file#enable-long-paths-in-windows-10-version-1607-and-later
• for git : start a git terminal as administrator run the following command : git config --system core.longpaths true

To clone the Catalyst repository use the command:

git clone https://github.com/catalyst-network/Catalyst.git

Then navigate into the repository:

cd Catalyst

Install the dependencies using the command:

git submodule update --init --recursive --force

5. Build the solution

Navigate to the src folder:

cd src

In the src folder build the solution:

dotnet build Catalyst.sln

6. Run the node

To run the node change to:

cd Catalyst.Node.POA.CE

Then use the command

dotnet run

You must now move on to configurifng your node as described below.

Configuring a Catalyst POA node

Currently on the POA network the catalyst peer ID and DFS peer ID are seperate. This will be changed soon however currently the node must be configured as follows:

1. If this is the first time that you have ran the node then you will be asked to create three passwords:

• Node password
• IPFS Password
• Certificate Password

Create these passwords and keep them safe (there is no way to recover these passwords as they are only held locally on your machine).

Once these three passwords have been set you must stop the node running this is generally done by pressing:

Ctrl + c

2. Find and copy your public key for later use, it should show in the console output or in the Catalyst logs like the following:

using PublicKey: 3edzejbuvme3ed4wqr5pp23if7rguoy7yddlcy3whijywzvo7lfq

3. Find your external ip address and copy it for later use: Whats My IP Address

4. Go to your home profile directory:

WINDOWS(cd %userprofile%/.catalyst) or LINUX / MacOS(cd ~/.catalyst)

5. Edit devnet.json and replace the Peer BindAddress and the RCP BindAddress with your internal IP address found using the command ipcconfig on Windows and ifconfig on Unix (MacOS / Linux) using IPV4. Then replace the Peer PublicIpAddress with your external ip address from Step 3 and replace the public key with your public key from Step 2.

6. Port forward if you are behind NAT. If your internal and external IP Addresses in step 5 were different then you are behind NAT. To port forward you will have to log into your router with administrator passwords found generally on the router.

Some common default IP addresses for router login are:

• BT - 192.168.1.254
• TalkTalk - 192.168.1.1
• EE - 192.168.1.1
• Virgin - 192.168.0.1
• Sky - 192.168.0.1

We have created a guide for the process for BT initially and to update with more examples however this process varies from router to router, some will not require log in and prot forwarding can be performed via an app e.g. Google Nest. However, the process remains generally the same. The guide can be found here:

BT Home Hub Port Forwarding

The port forwards that will need to be set up are as follows : 42076(udp) 42066(tcp) 4001(tcp) / API: 5005(tcp). Here is a guide on how to port forward Port Forward.

7. If not currently in 'Catalyst.Node.POA.CE' move to this directory. Re-run your node, enter your credentials again and the node should now be running.