Running Initia Node
Overview
Operating an Initia node demands significant server resources and is primarily necessary for specific tasks, such as developing dApps or functioning as validators.
Prerequisites
Hardware/OS Requirements
The minimum hardware requirements for running an Initia node are:
It is recommended to use Linux OS to run Initia nodes. Running Initia node has not been tested on other OS environments, and same environment settings and running conditions cannot be guaranteed.
Running Initia Node
Install Initia
Installing Initia can be done in 2 different ways.
Downloading the source and directly building Initia. (Go to Building Initia)
Using prebuilt binaries (Go to Using Prebuilt Initia)
Building Initia
Step 1: Build essential package
To build Initia, essential utilities must be installed. These utilities are provided on Linux distribution, and package components for Ubuntu can be found in the following link:
Step 2: Install Golang
golang v1.22 or above is required. Refer to the link to find out how to install Golang and use the command below to check the version.
Step 3: Clone and Build Initia
Clone and build the Initia source code repo.
Use the command below to check if the installation is successful.
If initiad
is not found, run go env
and check if $GOBIN or $GOPATH/bin directories are included in $PATH.
Using Prebuilt Initia
You can download pre-built binaries for each of Testnet or Mainnet(TBA) from the network repository. Download the compression file for your OS.
Below is an example of bash command line.
Oracle Requirements
Running an Initia node requires you to run an oracle sidecar as well. Please refer to this section for further instructions.
Set Up Environment
On Linux, the number of files that can be opened in a single process can be set on configuration. Many Linux distributions limit the number to 1024, which is smaller than the number of files opened by Initia. To use Initia, this configuration has to be modified.
The current value can be checked with ulimit -n
command, and root /etc/security/limits.conf
file can be modified to change this parameter. By adding the below to limits.conf
the maximum for all accounts can be increased to 65535. To only modify the number for the account running Initia, enter the account name instead of *
.
Last updated