Beginners guide to setting up Aethir node on the cloud using Ubuntu OS.
Setting up a VPS using Ubuntu OS is difficult for people who have no experience to setup. This tutorial will guide you from Step 0; Purchasing a VPS, all the way till your node is setup.
I will guide you through the entire process with brief explanations of what you need to know to manage things yourself.
By the end of this article, you will get your Aethir nodes running on your preferred VPS.
Step 0: Purchase your VPS
If you run 1–3 nodes. I highly recommend getting VLE-2.
- Aethir requires 1 Core, 64mb Ram, 10gb Space (Per Node)
- Carv requires 2 Cores, 4GB+ Ram, 100mb Space.
- Rivalz TBA
These requirements fit into VLE-2. Next, choose Ubuntu as the choice of your Operating Software.
Step 0.5: Choose the Operating System for your selected VPS
It is important to use Ubuntu OS instead of Windows for your VPS. It is built for up-time sensitive applications such as Checker Nodes.
Once you have purchased your desired VPS plan, its time to setup your Aethir Node(s)!
Step 1: Download SSH Client to access your VPS.
A VPS is a Virtual-Private-Server. You’ll need to log into it via credentials provided to you after the purchase of your VPS (Usually sent by email).
The recommended way to log into a VPS is using a SSH Client.
For this tutorial, please download the Termius SSH Client.
Termius is available on Windows, Mac OS, App Store and Google Play.
Step 1.5: Setup your SSH Login Credentials on Termius
Once you have Termius installed and received your VPS credentials, its time to log in!
Click on New Host
In the “IP or Hostname” field, input the IP/IPv4 address provided from your VPS Credentials.
At the bottom, you will see SSH on “22” port. Leave the port as it is.
In the “Credentials from Personal Vault” section, input the Username and Password provided by your VPS Credentials.
Once that is all set you should be able to click Connect and log into your VPS! To know if its successful, you should see this:
You have now logged in and reached the command-line step of setting up your nodes!
There are many community members that have posted a set of executable scripts for you to paste in here. You can continue to follow my guide as I show you how I set it up myself.
Take note: Pasting is CTRL + SHIFT + V instead of CTRL + V like on windows.
Step 2: Setting up your Node
Go to https://app.aethir.com click on “Download Checker Client”, right-click the “CLI For Linux” and copy the address.
The address for Checker Client V1.0.2.4 is as such:
https://checker-mainet-s3.s3.ap-southeast-1.amazonaws.com/na/AethirCheckerCLI-linux-1.0.2.4.tar.gz
The address changes as the checker version is updated. If this post is a few months old, likely the version has been updated so copy the latest one.
Step 2.1: Setting up an Aethir Screen in your Termius SSH.
Now, go back to Termius. I strongly suggest using the “Screens” functionality in Ubuntu as it can help you differentiate “screens” for each project’s nodes. I.e. you can create an Aethir screen and a Carv screen to manage each one.
screen -S Aethir
This will create your Aethir screen, and send you into that screen. This command should only be ran ONCE. And you are now in the Aethir screen.
The commands below are helpful ones when you log into your SSH Client again in the future.
To pop out of the screen, use CTRL-A + D keys.
Optional: To view all your created screens, type "screen -ls"
To go back to any created screen, type "screen -r Aethir"
If it says the screen is already attached, type "screen -dr Aethir"
Step 2.2: Download Aethir CLI, Unzip it, Execute Installation Script, Run Checker Node all via Command-Line.
Below are the commands to paste into the terminal to setup your Aethir Node. Please copy and paste them in one by one.
# These commands are for Latest Version V1.0.2.4 Aethir Checker CLI.
# This post was last updated on 5th July 2024.
wget https://checker-mainet-s3.s3.ap-southeast-1.amazonaws.com/na/AethirCheckerCLI-linux-1.0.2.4.tar.gz
tar -xvf AethirCheckerCLI-linux-1.0.2.4.tar.gz
cd AethirCheckerCLI-linux-1.0.2.4
#CHMOD COMMAND IS OPTIONAL.
#Merely gives full permissions to the folder for execution of installation.
#If sudo ./install.sh works fine, this is not needed
chmod -R 777 .
sudo ./install.sh
sudo ./AethirCheckerCLI
Press y to accept TOS.
Step 2.3: Create a new Burner Wallet
Take note before continuing, the “aethir” command is case sensitive. Do not use “Aethir” but use “aethir”
Next, type this in:
aethir wallet create
Your wallet details will then be created and pasted into the terminal. Now use CTRL + SHIFT + C, to copy your private key and public key and save it somewhere secure.
Step 2.4: Delegate your node to your Burner Wallet’s public key
Go to https://app.aethir.com/licenses and find your Node(s), click on “Delegate”
Input your newly created burner wallet’s public key and hit Delegate.
Step 2.5: Approve delegation on your SSH Client
aethir license list --pending
Check that the delegating from your portal is successful by seeing an item in the list of licenses pending
Then now run:
aethir license approve XXXXX
XXXXX is your License ID. Once sent, your node should be fully up and running! :)
Now, you can Pop-out of your Screen by running CTRL-A + D and setup any other project’s node as well.
Tutorials for Carv and Rivalz Nodes will come out in the future.
I hope this tutorial has been useful! This tutorial was provided by a community member of the:
- Starlaunch Community
- Aethir Community
- Carv Community
- Rivalz Community