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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nebulanetwork.ai/gpu-marketplace/overview/detailed-hosting-guide/nebula-hosting-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.