go-back

Academy

AIrDAO Node setup guide

6 min read

Thanks to the latest AirDAO website version, becoming a node validator and setting up your AirDAO node has never been simpler! This comprehensive guide will walk you through setting up Apollo nodes using the Digital Ocean.

Changes description

Previously, all node installation and management tasks were centralized in the command line. Now, the entire process of launching and operating nodes has been split into two stages:

  • Managing addresses and funds is done through the AirDAO website.
  • Managing the node server is handled through the command line.

This change was implemented to improve the security of our validators, ensure the network’s stability, and safeguard our users’ funds. Additionally, it has made launching and managing nodes more user-friendly and accessible, making the concept of running an AirDAO node even more appealing!

Part 1. Setting up the node via the AirDAO website

Step 1: Specify Your Node Address

Visit https://airdao.io/explorer/node-setup/, link your MetaMask wallet for node setup via “Connect wallet” button, and select the AirDAO network.

academy img

Consider generating a new wallet address as your second step for increased security. You can use a separate address for all node transactions, eliminating the necessity to hold funds in the node address.

Once the node is initiated, the Apollo nodes list on the website will display the chosen “Node Address.”

Step 2: Define the Node Owner Address

For increased security, selecting a separate wallet address for managing your node is advisable. “Node Owner” can manage several nodes at the same time.

academy img

You can also modify the node owner address on the dashboard page. Simply ensure you’re using the Node Owner’s address in your MetaMask wallet. Visit https://airdao.io/explorer/apollo/ and find your node in the list. Opening the node will reveal an additional menu, providing you with management options.

academy img

Kindly note that the transaction to deduct AMB for launching the node will originate from this address. Furthermore, it’s essential to recognize that a single Node owner can manage multiple nodes, each assigned a different node address.

Step 3: Choose the Rewards Receiver

Designate the address where your node rewards will be received. It can be another wallet address or a Node Owner address. Utilize the dropdown button to select the addresses chosen in the preceding steps. You will have the flexibility to update this address later via the node dashboard.

academy img

Step 4: Determine Your Node’s Stake Size

Specify the quantity of AMB you wish to stake. Node rewards are dynamic and contingent on the staked AMB amount.

Notice that the minimum staking position size is specified in the “input” field, and you must enter a value not lower than the specified amount. Additionally, when entering the amount, ensure that the “Node Owner” is chosen in MetaMask.

academy img

You can adjust the stake size later on the node dashboard. If you reduce the stake size or retire your node, your funds will be returned to your wallet 15 days after the transaction confirmation.

academy img

Please note that not all active nodes will participate in blockchain validation and receive rewards. The AirDAO Council will decide the specific number of validating nodes in the blockchain, and this number may be subject to change in the future. To increase the likelihood of your node becoming a validator, please review the nodes list and ensure that your stake size is significant enough to rank among the top nodes with the largest stake size. Nodes with smaller stake sizes may be placed on a waiting list. If your stake size is insufficient for running a node, consider the AMB Staking program as an alternative.

You will be directed to a page displaying the provided information upon confirming the node launch amount. Here, you can review the details, modify pre-established addresses by selecting the “change” button, and, if necessary, return to the previous steps.

academy img

Please note that the transaction to debit the specified amount for launching the node will be executed from the node owner’s address. Therefore, it’s crucial to ensure that:

  • Sufficient AMB is available at this address;
  • This address is selected and accessible in your Metamask wallet at this stage.

Failure to meet these conditions may result in the transaction being canceled.

Once the transaction is successfully completed, you will receive a confirmation and the command required to initiate the node on the VPS server.

Command to launch the node:

source <(curl -s https://raw.githubusercontent.com/ambrosus/airdao-nop/master/setup.sh)

Part 2. Setting up the VPS server & activating the node

What is a Virtual Private Server (VPS)?

A Virtual Private Server offers users the unique ability to operate their server within a shared physical infrastructure. To illustrate, envision it as securing an office space in a vast building. You own the space and can tailor it to our specific requirements, yet other individuals collectively use the building.

The term “Virtual Private Server” is aptly named because it relies on virtualization technology, enabling the host, in our case, DigitalOcean, to partition a single server into multiple distinct ones. The attribute “private” indicates that the server is exclusively accessible by you, and resources, like RAM, CPU, and storage, are allocated solely to your server, as defined during the VPS setup.

Why should we use a VPS?

Our VPS serves as the hub for setting up and operating our node. Instead of running nodes on our personal desktop machines, leveraging a VPS provides numerous advantages, including robust availability, simplified setup and configuration, and potential for future expansion and scalability.

Step 5: Setup a DigitalOcean Droplet

To start, initiate the process by establishing an account on DigitalOcean. After successful registration, login and create a “New project,” giving it a suitable name.

When prompted to specify the type, opt for “Service or API.” If there’s an inquiry regarding relocating resources, kindly disregard it.

academy img

Now, navigate to your freshly created project. With this project in place, it’s time to introduce our VPS server, which DigitalOcean calls a ‘Droplet.’

Access the ‘Create’ tab and select ‘Droplet’ from the menu atop the page. At this juncture, it’s vital to specify the configuration and details of our server.

academy img

Choose the following options:

  • Select any data center region — AirDAO developers suggest picking the closest server to your location;
academy img
  • Ubuntu 22.04 x64. Please note this operating system’s version is not selected by default;
academy img
  • Basic Plan;
academy img
  • CPU options — regular, $18 / month with 2 CPU / 2 GB memory / 60 GB SSD storage;
academy img
  • Additional storage — skip;
  • Add and select your SSH key or set up a password (it is recommended to add SSH key to increase security);
academy img
  • Name the droplet and assign it to our project;
academy img
  • Click “create droplet” and wait until the server starts running. You’ll be brought to another page where you can see the status of your server as it spins up.
academy img

After the server starts, it will appear in the list of available servers. Double-click on the server name to open a page with detailed information about the VPS server. In the upper right corner, click the “Console” button to open the command line.

Step 6. Run the node setup

Follow these steps for node installation:

  • Begin by pasting the command mentioned at the end of the initial part of this guide into the Command Prompt (CMD) to commence the node installation process.

(source <(curl -s https://raw.githubusercontent.com/ambrosus/airdao-nop/master/setup.sh)

  • Once the installation process concludes, with the latest updates installed, you’ll observe the AirDAO logo displayed on the command line.
academy img
  • The next prompt will ask you to select the network you wish to operate on, and you should choose ‘main.’
academy img
  • Subsequently, you’ll be prompted to input the private key or generate a new key automatically. Pick the first option and use the key associated with the address where the node is currently active. You can find this key in your MetaMask wallet. Go to Account details by clicking on the three dots adjacent to your account name.
academy img
  • After the key is accepted, you must specify the node’s IP in agreement with the VPS server address, which is automatically determined.

This concludes the node launch process. Await a notification confirming a successful launch and a message indicating the time until the node becomes operational. This time frame signifies the minimum duration the node must be online for a successful launch.

Congratulations, you’re officially an AirDAO node operator!