install-node.md

Install Node

This page explains how to download and build the WorldLand source code and install the Worldland node.

Hardware Requirements

	Minimum	Recommended
CPU	2+ cores	Fast CPU with 4+ cores
RAM	4GB	8GB+ RAM
Storage	500GB free storage	500 high-performance SSD
Internet	8 MBit/sec	25+ MBit/sec

Linux and Mac

1. Environment

Linux

We wrote the document based on Ubuntu, but it is expected to work on UNIX-like operating systems as well.

Download the basic packages needed for the build.

sudo apt update
sudo apt upgrade

For building WorldLand, it requires Go (version 1.18 or later). You can install them using the following commands.

sudo apt install gcc
sudo apt install make
sudo apt install snapd
sudo snap install go --classic

Mac

We wrote the document based on Ubuntu, but it is expected to work on UNIX-like operating systems as well.

Download the basic packages needed for the build.

sudo brew update
sudo brew upgrade

For building WorldLand, it requires Go (version 1.18 or later). You can install them using the following commands.

sudo brew install gcc
sudo brew install make
sudo brew install snap
sudo brew install go

Then Go will be installed

Check the version of Go (version 1.18 or later)

$ go version

2. Installation

You can download WorldLand by cloning the WorldLand repository.

git clone https://github.com/cryptoecc/WorldLand

Once dependencies are installed, You can install WorldLand using the following command.
Then move to /WorldLand, and follow this.

cd WorldLand
make worldland

or to build the full suite of utilities:

make all

Installation complete!

To run the WorldLand, write the following command.

./build/bin/worldland --datadir "USER_DATA_DIR" console

Window

You can use the Windows Installer or build the WorldLand source code yourself.

Using Installer

Download the installer exe file from the latest release of the WorldLand repository.

If blue window like the picture below appears, click More Information and run it.

Run the downloaded installer file.

If the following error message is displayed, You must manually add the installation path to environment variables. Add the installation path to Path in your environment variables.

Add the installation path to Path in your environment variables.

Default installation path:

C:\Program Files\worldland

Installation complete!

To run the WorldLand, write the following command.

C:\Users\xxx\src\github.com\cryptoecc\WorldLand> worldland --datadir "USER_DATA_DIR" console

Run and Build

1. Install Chocolatey

The Chocolatey package manager provides an easy way to install the build tools you need.

Run PowerShell in administrator mode.

PS C:\WINDOWS\system32>

With PowerShell, you must ensure Get-ExecutionPolicy is not Restricted.

PS C:\WINDOWS\system32> Get-ExecutionPolicy

If it is Restricted, set it to AllSigned or Bypass.

PS C:\WINDOWS\system32> Set-ExecutionPolicy AllSigned

or

PS C:\WINDOWS\system32> Set-ExecutionPolicy Bypass -Scope Process

Now run the following command:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Wait a few seconds for the command to complete. If you don't see any errors, you are ready to use Chocolatey!

2. Installation

Then you can run the following command from an administrator command prompt to install the build tools:

Installing these packages sets the path environment variable.

C:\Windows\system32> choco install git
C:\Windows\system32> choco install golang
C:\Windows\system32> choco install mingw

{% hint style="danger" %} You will need to open a new command prompt to get the new path. {% endhint %}

To install WorldLand, you can first create a Go workspace directory, then create and build the WorldLand source code.

C:\Users\xxx> mkdir src\github.com\cryptoecc
C:\Users\xxx> git clone https://github.com/cryptoecc/WorldLand src\github.com\cryptoecc\WorldLand
C:\Users\xxx> cd src\github.com\cryptoecc\WorldLand
C:\Users\xxx\src\github.com\cryptoecc\WorldLand> go get -u -v golang.org/x/net/context
C:\Users\xxx\src\github.com\cryptoecc\WorldLand> go install -v ./cmd/...

If you get fatal: detected dubious ownership in repository at error Execute the command below indicated in the log message.

git config --global --add safe.directory "USER_DATA_DIR"

or the build fails, run the command below and retry.

C:\Users\xxx\src\github.com\cryptoecc\WorldLand> go mod tidy

Installation complete!

To run the WorldLand, write the following command.

C:\Users\xxx\src\github.com\cryptoecc\WorldLand> worldland console

---

References:

{% embed url="https://geth.ethereum.org/docs/getting-started/installing-geth" %}

{% embed url="https://chocolatey.org/install#individual" %}

---