# 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.

{% hint style="info" %}
If you are using an **AMD EPYC CPU**, be aware of known **IOMMU issues** with NVIDIA GPUs. Check the **NVIDIA NCCL documentation** for troubleshooting.
{% endhint %}

***

### **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**

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

{% hint style="info" %}
Ensure that **Docker** and the **NVIDIA drivers** are correctly installed. Use `nvidia-smi` to confirm GPU detection.
{% endhint %}

#### **Step 2: Install the Hosting Software**

```bash
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:

```bash
bashCopyEditsudo apt install -y git
```

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

```bash
bashCopyEditsudo apt install gpg -y --allow-downgrades
```

Restart the system to apply all changes:

```bash
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:

```bash
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:

```bash
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:

```bash
bashCopyEdithive-replace -y --stable
```

2. **Expand Disk Space** (if needed):

```bash
bashCopyEditgrowpart /dev/nvme0n1 4
resize2fs /dev/nvme0n1p4
```

3. **Install Hosting Software in HiveOS**:

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

4. **Reboot and Verify GPU Registration**:

```bash
bashCopyEditreboot
```

***

### **Updating NVIDIA Drivers**

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

```bash
bashCopyEditnvidia-driver-update
```

Reboot the system after updating.

***

### **Disabling Auto-Updates (Recommended)**

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

```bash
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:

```bash
bashCopyEditsystemctl restart nebula-hosting
```

* Check logs for errors:

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

If network issues occur:

* Ensure required ports are open:

```bash
bashCopyEditufw allow 22
ufw allow 80
ufw allow 443
```

For persistent errors, visit the [**Nebula AI Discord**](https://discord.com/) for community support.

***

### **Removing or Resetting Hosting Software**

If you need to reset your hosting configuration:

* To disable hosting services:

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

* To **re-enable services**, use:

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

* To completely **remove the hosting client**, run:

```bash
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!