System Setup

This section provides a guide for how to configure your Ubuntu system

Before continuing with this section you should ensure that your environment is up to date

sudo apt update
sudo apt upgrade

After updating your environment you will need to install the required packages

sudo apt install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang

Step 1: Create a new user

We recommend running the validator under a user that is not root for security reasons. Create a user to run the validator

sudo adduser koii
sudo usermod -aG sudo koii

Elevate into the user

sudo su koii

Step 2: Install the Koii software

We host an install script that will install and configure the Koii validator software. Run it with the following command

sh -c "$(curl -sSfL https://raw.githubusercontent.com/koii-network/k2-release/master/k2-install-init_v1.14.19.sh)"

This script will install and configure the validator software with an identity key and the koii cli configured for testnet. It is important to note that this identity key created is not your validator identity. If you have a private key that is funded for staking with a validator you can replace the one generated with this script.

If everything is configured correctly you can test it by running koii balance which will return the balance of the local key.

Step 3: Run the System Tuner

This will configure certain aspects of your system to better support the validator.

koii-sys-tuner --user koii

Step 4: Allow traffic on ports

If you have firewall software installed you will need to allow traffic on the following ports:

TCP and UDP for ports 10000-10500

TCP for port 10899