Skip to content
This repository was archived by the owner on Feb 22, 2026. It is now read-only.

Run a POA node on Windows

Joseph Kearney edited this page Apr 2, 2020 · 16 revisions

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.

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.

Unix environments

Download and install msbuild prebuild tasks from Rust. MsBuild will then compile the Bulletproof library when you try to build the project.

Then, make sure you install Rust using the rustup tool:

curl https://sh.rustup.rs -sSf | sh

If rustc --version fails, restart your console to ensure changes to PATH have taken effect.

Refer to the Rust cryptography library repository for docs. If you have issues with this part of the installation, please raise them there.

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 Snappy for rocksdb (Unix systems only)

Snappy must be installed for Linux and MacOS opperating sytems

For linux using: sudo apt-get install libsnappy-dev

For MacOS install brew following: https://brew.sh/

Then:

brew install snappy

4. Create a self signed certificate (Linux only)

If you're on Linux, you need to create a Self Signed Certificate the instructions for which are found here:

Create a Self Signed Certificate

5. Install MongoDB

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

6. Clone the repository

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

Windows environment prerquisite - Enable long paths

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

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

7. Build the solution

Navigate to the src folder:

cd src

In the src folder build the solution:

dotnet build Catalyst.sln

8. Run the node

To run the node change to:

cd Catalyst.Node.POA.CE

Then use the command

dotnet run

Configuring the node

Once the above steps have been completed the node must be manually configured following:

How to configure a Catalyst POA node

Clone this wiki locally