⚙️ Voi Swarm

🛠️ Hardware Requirements

Node Type	CPU	RAM	Storage	Bandwith
Voi Swarm (Minimum)	8v CPU / 4CPU Cores	8 GB	100 GB storage	100 Mbps network
Voi Swarm (Recommended)	16v CPU / 8 CPU Cores	16 GB	100 GB storage	1 Gbps network

You can look for a provider to rent a server or use your own, with the characteristics indicated above. The project team also emphasizes that Contabo servers are not a good option for Voi Network, so it is better to choose another provider.

Additional requirements

• Ubuntu - 20 or newer.

• System packages: curl,wget

• Ability to run as root or permission to use sudo

• Bandwidth: min. 100 Mbps

• Ports 4160,7833,8080,9100 are not occupied by another process

Node version	Binary Home
3.25.0	$HOME/voi

📝 Manual installation

⏱️ Installation time - 30-60 minutes

📌 Step 1: Installation packeges and dependencies

# Install dependencies for building from source
sudo apt update
sudo apt install -y lz4 jq make git gcc build-essential curl chrony unzip gzip bc wget screen

📌Step 2: Create screen session

We will continue installing the node in screen mode, this will allow you to install the node without additional problems in the form of sudden disconnection from the server, unstable Internet connection, etc. Useful commands: screen -ls - view all active sessions screen -r voi - return to the voi session (for example, if you switched to the server) Ctrl + A + D - close the session with the possibility to return to it later

screen -S voi

After entering the command, you will be taken to a screen session called "voi".

📌 Step 3: Install node

1. Type the following command in the terminal to install.

/bin/bash -c "$(curl -fsSL https://get.voi.network/swarm)"

2. Enter a name for your node that you can later find in Telemetry and see how your node is performing.

3. Create a Voi wallet password

4. Save your address to which you will request tokens in the next step.

Now in the terminal you need to save your address, request tokens in the discord of the project following the next step "5" and then return to the terminal and enter "completed"

5. Request tokens in the project discord.

• Join Discord, get role and request tokens in any of the available channels

• Go to any channel and enter the command:

• /voi-testnet-faucet and press the spacebar, then insert your address to which you will request 2000 VOI, there is a limit on invitations, namely 2 times for 2000 VOI

After entering, pass the captcha

Click "Ok"

Or if the faucet is not working you can ask others to send you tokens in chat. Until you get at least 1 Voi you cannot proceed with the installation

6. After the faucet, return to the terminal and enter completed to continue the installation.

7. Carefully read everything highlighted in red, enter the password, and save the mnemonic phrase to restore your wallet in case of loss or recovery.

After that, your node is fully installed, now you can exit screen mode and never return to it:

• Use Ctrl + A +D - you can minimize the screen and return to it if needed in the future.

• Use Ctrl + D - you can close the session completely.

📌Step 4: Get node status and save GUID

Run this script

~/voi/bin/get-node-status

• Save the GUID value -

• You can also see here the validity period of your generated participation key, and the approximate date when you will need to renew this key, this will be indicated later.

By this point you should have:

• installed node

• saved: address, mnemonic phrase, guid

📌Step 5: Checking the status of the node

You can return to this point every time you want to check the operation of your node.

As a node runner it's very important to check the health of your node regularly to detect any anomalies that could cause your health to fall below the threshold score of 5 for the hour, day or week.

If your node has a health score below 5 each week you are not earning any points towards the airdrop!

1. Check the log log on the server

Run this script

docker logs -f $(docker ps --filter "name=voinetwork_algod" --format "{{.ID}}" | head -n 1)

If you see logs similar to these, everything is fine

2. Check your node in the following checkers

You will not be able to find yourself here immediately after installing the node, you may have to wait a few hours, after that only check the node.

• Node Finder: Find your node by its GUID and name on the "HOURLY' section. Ensure your node's health is greater than 5.

• Node Health Checker: Use this website to ensure your node remains healthy for each week.

Example:

• Node Reward Auditor: Lookup your node by your address to ensure you are earning points.

Example

Well done, now it's up to you to keep an eye on the node and keep the node above 5 healthy. You can also perform other tasks within the Voi Network project.