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:

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

Available only on Testnet:

Claim some ETH token tokens from our Testnet Faucet (opens in a new tab).
Bridging the token from Arbitrum Sepolia to Spheron Testnet from our Spheron Bridge (opens in a new tab)

Look for and click on the "Register a Fizz Node" button to start the registration process.
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.
- Payment Tokens: Choose the cryptocurrencies or tokens you will accept as payment for your services.
- 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 1000 fizz node so select another gateway which is nearest to you.
  - Proximity to the gatewa, 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.
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).
(Optional) If the Spheron faucet is not working, you can obtain ETH from Arbitrum Sepolia and bridge it to the Spheron chain:

a. Get Arbitrum Sepolia ETH from one of these faucets:
b. Once you have ETH on Arbitrum Sepolia, use the Spheron Bridge (opens in a new tab) to transfer ETH to the Spheron chain.

c. After bridging, check your balance on the Spheron chain to ensure the transfer was successful.

This step is only necessary if you could not get ETH from the Spheron faucet. You can skip this step if you successfully obtained ETH from the Spheron faucet.

Now click on the "Register" button.
Once you confirm the transaction, 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:

Look for a magnifying glass icon at the top right of your screen. That's called Spotlight.
Click on it or simultaneously press the Command (⌘) key and Space bar.
Type "Terminal" and press Enter.
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:

Click inside the Terminal window.
Type or copy-paste one of the commands above.
Press the Enter key.
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

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:

Access the setup page for your registered node. There, You should find a link to download the fizzup.sh script.
Download the fizzup.sh script to your machine. Make sure to save it in a location you can easily access via a terminal or command prompt.
Open your terminal or command prompt and navigate to the directory where you saved the script.
Make the script executable by running the following command:
```
chmod +x <location of fizzup script>/fizzup.sh
```
Replace <location of fizzup script> with the actual path to the script's directory.
Run the script by entering the following command:
```
<location of fizzup script>/fizzup.sh
```
This command executes the script and starts the Fizz node client on your machine.
To verify if your Fizz node is running, use the following command:
```
docker-compose -f ~/.spheron/fizz/docker-compose.yml logs -f
```
If this doesn't work, try:
```
docker compose -f ~/.spheron/fizz/docker-compose.yml logs -f
```
These commands will show you the logs of your Fizz node, allowing you to confirm it's running correctly.
Once you've verified the node is running, return to the setup page on the Spheron Fizz App.
On the setup page, you'll see a "Check Status" button and a switch to "Automatically check status."
Click the "Check Status" button to manually initiate a status check for your Fizz node.
Alternatively, you can toggle on the "Automatically check status" switch to have the system periodically check your node's status without manual intervention.
The system will now perform checks to validate if your node is active and correctly configured.

The validation process may take a few minutes. During this time, the system verifies your node's connectivity, resource availability, and configuration.

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.

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

⚠️

Remember to keep your node running and maintain a stable internet connection to maximize your deployment opportunities and earnings.

Fizz Hardware Requirements Fizz Reward Details