Skip to main content

System Setup

All following steps need to be run on the validator server, unless mentioned otherwise.

1. Ensure system is up-to-date

Ensure your Ubuntu system is up-to-date and has all the base packages required

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

2. User setup

sudo adduser koii
sudo usermod -aG sudo koii
sudo su koii
cd ~

3. Koii cli setup

  • Required both on your secure computer for keypair generation and on the validator
sh -c "$(curl -sSfL"
# You may need to update PATH variable for the cli to be available
echo 'export PATH="/home/koii/.local/share/koii/install/active_release/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# Set the koii config to point to the testnet
koii config set --url

4. Key pairs creation

Run commands for only this step on a secure computer separate from the validator server You need to install Koii cli on this secure computer as well, to be able to use the commands below

We will be creating the following 4 key pairs:

koii-keygen new --outfile ~/validator-keypair.json
koii-keygen new --outfile ~/vote-account-keypair.json
koii-keygen new --outfile ~/stake-account-keypair.json
koii-keygen new --outfile ~/authorized-withdrawer-keypair.json
# To print your Public key(i.e. Wallet address) for any keypairs
# koii-keygen pubkey <Path to Keypair>
  • validator-keypair.json : Identity of the validator on the network
    • Copy this to the remote validator server at /home/koii/validator-keypair.json
  • vote-account-keypair.json : Voting account on the network
    • Copy this to the remote validator server at /home/koii/vote-account-keypair.json
  • stake-account-keypair.json : Keypair for your staking wallet
    • Keep this secure since this will hold the wallet that you delegate stake from
  • authorized-withdrawer-keypair.json : Authorized withdrawer keypair, allowed to withdraw funds from your validator vote account ****

The authorized withdrawer keypair is the ultimate authority over your validator. This keypair will be able to withdraw from your vote account and will have additional permission to change all other aspects of your vote account. Anyone in possession of it can permanently take control of your vote account and make any changes as they please.


stake-account-keypair.json and authorized-withdrawer-keypair.json must be stored in a secure location NOT on the validator.

5. Network configuration

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

sudo ufw allow 10000:10500/udp
sudo ufw allow 10000:10500/tcp
sudo ufw allow 10899/tcp
sudo ufw allow 10900/tcp

6. Systuning setup

  • Create a file at /etc/systemd/system/systuner.service :
    Description=Koii System Tuner
    ExecStart=/home/koii/.local/share/koii/install/active_release/bin/koii-sys-tuner --user koii

  • Start and Enable the service to automatically start
    sudo systemctl start systuner
    sudo systemctl enable systuner