Nebula Hosting Client

Installing Nebula AI Hosting Software

Hosting your GPU on Nebula AI requires setting up the Nebula Hosting Client, ensuring proper system configurations, and registering your hardware on the platform. This guide provides a step-by-step approach to installing the hosting software, optimizing system performance, and preparing your machine for rental.

---

System Requirements

To ensure stability and optimal performance, your hardware must meet the following minimum requirements:

• GPU: NVIDIA GPUs are required (AMD support is coming soon). The system must have at least one dedicated GPU.

• Disk Space: Minimum 32GB of storage; SSD or NVMe drives are recommended for reliability.

• RAM: At least 8GB of RAM, though 16GB+ is recommended for handling multiple workloads.

• CPU: A multi-core processor (Intel i7 or equivalent recommended). Lower-end CPUs (e.g., Celeron) may function but could bottleneck performance.

• Operating System: Ubuntu 20.04 or newer is recommended for stability.

• Networking: A stable internet connection with open firewall ports for SSH access.

Before proceeding with installation:

1. Reset your GPU to factory settings to prevent overclocking-related instabilities.

2. Run a stress test (e.g.kawpow or cuda-burn) to verify stability before installation.

3. Ensure proper cooling and monitor GPU temperatures to prevent overheating.

---

Installing Ubuntu (If Not Already Installed)

If your system does not have Ubuntu installed, follow these steps:

1. Download Ubuntu: Use the latest 64-bit Ubuntu Server or Desktop ISO from the official website.

2. Create a Bootable USB: Use Rufus (Windows) or dd (Linux) to write the ISO onto a USB drive.

3. Install Ubuntu:

   • Select "Something Else" in the partition setup.

   • Create a 512MB EFI partition, a 32GB EXT4 partition for Ubuntu, and leave the rest unallocated for XFS storage.

   • Complete the installation and ensure networking is enabled.

If you are using an AMD EPYC CPU, be aware of known IOMMU issues with NVIDIA GPUs. Check the NVIDIA NCCL documentation for troubleshooting.

---

Installing Nebula AI Hosting Software

To install the Nebula Hosting Client, run the following commands in your terminal:

Step 1: Update System and Install Dependencies

bashCopyEditsudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git docker.io nvidia-driver-535

Ensure that Docker and the NVIDIA drivers are correctly installed. Use nvidia-smi to confirm GPU detection.

Step 2: Install the Hosting Software

bashCopyEditbash <(curl -s https://nebulanetwork.ai/install.sh)

This command downloads and executes the official Nebula AI Hosting Client installer.

If the system reports missing git, install it using:

bashCopyEditsudo apt install -y git

If you encounter a GPG key error, resolve it with:

bashCopyEditsudo apt install gpg -y --allow-downgrades

Restart the system to apply all changes:

bashCopyEditsudo reboot

---

Registering and Adding Your GPU to Nebula AI

Once the software is installed, register your GPU to begin hosting:

1. Login to Nebula AI and navigate to the Hosting Dashboard.

2. Add a New GPU by entering your system details.

3. Obtain Your Hosting Token from the dashboard.

4. Activate Your Machine by running:

bashCopyEdit/opt/nebula-hosting/nebula.sh --init-token <your-token>

Replace <your-token> with the key obtained from the platform.

To verify that your GPU is successfully added, check:

bashCopyEdit/opt/nebula-hosting/nebula.sh --status

If the setup was successful, your system will be marked "Active" in the marketplace.

---

HiveOS Setup (Optional)

If you are using HiveOS for GPU management, follow these additional steps:

1. Open Hive Shell and update the system:

bashCopyEdithive-replace -y --stable

1. Expand Disk Space (if needed):

bashCopyEditgrowpart /dev/nvme0n1 4
resize2fs /dev/nvme0n1p4

1. Install Hosting Software in HiveOS:

bashCopyEditwget -O - https://nebulaai.com/install-hiveos.sh | bash

1. Reboot and Verify GPU Registration:

bashCopyEditreboot

---

Updating NVIDIA Drivers

If your system has outdated GPU drivers, update them manually:

bashCopyEditnvidia-driver-update

Reboot the system after updating.

---

Disabling Auto-Updates (Recommended)

To prevent driver mismatches, disable Ubuntu’s automatic updates:

bashCopyEditsudo systemctl stop unattended-upgrades
sudo systemctl disable unattended-upgrades

This prevents NVIDIA driver updates from breaking the hosting service.

---

Troubleshooting Common Issues

If your machine does not appear in the marketplace:

• Run nvidia-smi to check if the GPU is detected.

• Restart the hosting client:

bashCopyEditsystemctl restart nebula-hosting

• Check logs for errors:

bashCopyEditjournalctl -u nebula-hosting --no-pager | tail -n 50

If network issues occur:

• Ensure required ports are open:

bashCopyEditufw allow 22
ufw allow 80
ufw allow 443

For persistent errors, visit the Nebula AI Discord for community support.

---

Removing or Resetting Hosting Software

If you need to reset your hosting configuration:

• To disable hosting services:

bashCopyEditsystemctl disable nebula-hosting.service
systemctl disable docker.service
systemctl disable docker.socket
reboot

• To re-enable services, use:

bashCopyEditsystemctl enable nebula-hosting.service
systemctl enable docker.service
systemctl enable docker.socket
reboot

• To completely remove the hosting client, run:

bashCopyEditrm -rf /opt/nebula-hosting/

---

Finalizing Setup

Once your machine appears in the Nebula AI Marketplace, verify its status and configure rental pricing in the Hosting Dashboard. Your GPU is now ready to earn through decentralized computing!