Setup Fizz Node

Setting up a Fizz node allows you to participate in the Spheron network and earn points by providing computational resources. This guide will walk you through the process of registering and setting up your Fizz node.

Registration Process

To begin, you must register your Fizz node on the Spheron network. Follow these steps:

1. Navigate to fizz.spheron.network (opens in a new tab) in your web browser.

2. Look for and click on the "Register a Fizz Node" button to start the registration process.

3. You'll be presented with a registration form. Fill it out carefully with the following information:

   • Operating System: Select your node's OS from the options provided (MacOS, Linux, or Windows).
   • Node Type: Specify whether you're setting up a GPU node or a CPU node. This determines the type of computational resources you'll be providing.
   • GPU Model (if applicable): If you selected GPU node, choose the specific GPU model you're using.
   • Resource Details: Provide accurate information about the resources you're willing to lend, including:
     • CPU cores
     • RAM capacity
     • Available storage
     Learn more about how to check your system specs and resources in this Section.

   • Region: Select the geographical location where your node is situated. This helps users choose nodes based on their proximity requirements.
   • Gateway Selection: This is a crucial step. Choose a gateway carefully, considering factors such as:
     • The number of fizz nodes connected to the gateway. A gateway can't connect more than 2000 fizz node so select another gateway which is nearest to you.
     • Proximity to the gateway, make sure you choose the gateway which is nearest to you so that the latency is not too high for users who want to use your GPU / compute.
     • Try to select the recommended gateway in the list as the dashboard already selects the gateway based on your node preferences.

4. To complete the registration, you'll need some ETH on the Spheron chain for gas fees. If you don't have any, you can get some from our faucet at faucet.spheron.network (opens in a new tab).

5. Now click on the "Register Your Fizz Node" button.

6. For the Stellar phase and beyond, node registration requires:

   • A deposit of 0.02 ETH
   • This can be deposited on any of our supported mainnet chains:
     • Base
     • Arbitrum
     • ZkSync Era
     • BNB Chain
     • Ethereum

7. Click on "Proceed with Payment" button. Why taking a fee?

8. Once you confirm all the transactions including the deposit, your node will be officially registered in the Spheron network, and you can proceed to the next steps.

Learn About Your System Specs / Resources

Mac Users: How to Check Your System Configuration

Before we start, you need to open something called the Terminal. It's like a special notepad where you can type commands to talk to your computer. Here's how to find it:

1. Look for a magnifying glass icon at the top right of your screen. That's called Spotlight.
2. Click on it or simultaneously press the Command (⌘) key and Space bar.
3. Type "Terminal" and press Enter.
4. A white or black window will open. That's the Terminal!

Now that you have the Terminal open, you can type these magic words (we call them commands) to learn about your computer:

• Check Storage Type:

  system_profiler SPStorageDataType

• Check Hardware Specifications:

  system_profiler SPHardwareDataType

• Check GPU Type:

  system_profiler SPDisplaysDataType

Linux Users: How to Check Your System Configuration

To use these commands:

1. Click inside the Terminal window.
2. Type or copy-paste one of the commands above.
3. Press the Enter key.
4. The computer will show you some information. That's what we're looking for!

• Check Storage Information:

  df -h

• Get Detailed Hardware Information:

  sudo lshw

• List CPU Information:

  sudo lshw -class processor

• List Memory Details:

  sudo lshw -class memory

Running the Fizz Node Client (Linux/Mac)

After successfully registering your node, you need to set up and run the Fizz node client on your machine. This client software connects your node to the Spheron network and manages resource allocation. Follow these steps:

1. Open your terminal or command prompt and run the following command in your terminal to install the Fizz CLI:

curl -sL https://sphnctl.sh | bash  

2. Go to the Setup page on the Fizz Website. Click “Generate Command” to obtain your node-specific commands.

3. Use the below command to start your node, replacing the ... with your node-specific token:

sphnctl fizz start --token ...  

4. Monitor your node’s logs to ensure it is running smoothly:

sphnctl fizz logs  

5. Verify that the CLI and node versions are up-to-date by running the following command:

sphnctl fizz version  

6. Once you've verified the node is running, return to the setup page on the Spheron Fizz App.
7. On the setup page, you'll see a "Check Status" button and a switch to "Autocheck status."
8. Click the "Check Status" button to manually initiate a status check for your Fizz node. Or you can run the below command on CLI.

sphnctl fizz status  

9. Alternatively, you can toggle on the "Autocheck status" switch to have the system periodically check your node's status without manual intervention.
10. The system will now perform checks to validate if your node is active and correctly configured.

11. Once your node is confirmed active, you will be automatically directed to your Fizz dashboard.

Running the Fizz Node Client (Windows)

1. Before proceeding, ensure your NVIDIA drivers and CUDA version are up-to-date. Open your terminal and run:

nvidia-smi

2. If an update is required, visit the official NVIDIA Drivers (opens in a new tab) page to download and install the latest version.

3. If WSL is already enabled, skip this step. Open PowerShell as an administrator and execute:

wsl --install

This will Enable WSL, Set WSL 2 as the default version and Install a default Linux distribution. Restart your system if prompted.

4. If your Linux distribution is outdated, install Ubuntu 22.04. Open the Microsoft Store and Search for Ubuntu 22.04. Install it.

5. If Docker Desktop is already configured for WSL, skip this step. Download Docker Desktop (opens in a new tab) from the official website. During installation, select Use WSL 2 instead of Hyper-V. Restart if prompted.

6. Open Docker Desktop and Go to Settings > General. Ensure WSL 2 is selected as the backend. Enable integration with Ubuntu. Click "Apply & Restart".

7. Go to Resource > WSL Integration > Enable Ubuntu. Click "Apply & Restart".

8 Launch Ubuntu as Administrator & Run the following command to install the Spheron CLI

curl -sL https://sphnctl.sh | bash

9. Go to the Setup page on the Fizz Website. Click “Generate Command” to obtain your node-specific commands.

10. Use the below command to start your node, replacing the ... with your node-specific token:

sphnctl fizz start --token ...  

11. Monitor your node's logs to ensure it is running smoothly:

sphnctl fizz logs  

12. Verify that the CLI and node versions are up-to-date by running the following command:

sphnctl fizz version  

13. Once you've verified the node is running, return to the setup page on the Spheron Fizz App.
14. On the setup page, you'll see a "Check Status" button and a switch to "Autocheck status."
15. Click the "Check Status" button to manually initiate a status check for your Fizz node. Or you can run the below command on CLI.

sphnctl fizz status  

16. Alternatively, you can toggle on the "Autocheck status" switch to have the system periodically check your node's status without manual intervention.
17. The system will now perform checks to validate if your node is active and correctly configured.

18. Once your node is confirmed active, you will be automatically directed to your Fizz dashboard.

Accessing Your Dashboard

After your node has been successfully validated and marked active, you'll be redirected to the main Fizz node dashboard. This dashboard is your control center for managing your node and tracking your earnings. Here's what you can expect:

• Node Status: Real-time information about your node's activity and health.

• Resource Utilization: Graphs and statistics show how your node's resources are used.

• Earnings Tracker: A detailed breakdown of your points and earnings from providing resources to the network.

• Settings and Configuration: Options to adjust your node's resource settings or modify available resources.

• Node Status: Provides real-time information about your node, including its current state (Active or Inactive), uptime, geographical location, and operating system. Also, you can view your node's unique identifier, associated address, and CLI status.

• Upgrade Notification: Alerts you to update your Fizz Node to the latest version to maintain optimal performance and avoid penalties like losing FN points. Includes a direct link to the setup page for easy upgrading.

• Resource Tiers: Displays your progress across various tiers, highlighting achievements and current tier level. For example, an “Lunar Fizz Operator" badge signifies special recognition for Phase 2 Fizzers.

• Points Summary: Shows key metrics, including the Phase 1 CPU Multiplier, points earned per era, and total points.

• Resource Allocation: Detailed insights into your node's resources, including CPU, RAM, and Storage, with values for utilized, allocatable, and claimed resources.

• Bandwidth Usage: A live gauge shows your node's current bandwidth performance.

• Gateway Information: Displays the active gateway your node is connected to, such as "spheron-testnet."

Check your dashboard regularly to ensure your node performs optimally and stay informed about your earnings in the Spheron network.