> For the complete documentation index, see [llms.txt](https://docs.aethir.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aethir.com/aethir-cloud/aethir-cloud-host/cloud-host-portal-guide/manage-gpus.md).

# Manage GPUs

To participate in Aethir Cloud, Cloud Hosts must onboard their GPUs to the platform.

**Important Restrictions:**

* **Compute resources located in mainland China or behind a VPN are not allowed.**
* **Compute resources must run Ubuntu 18 or later.**

### Adding GPUs

#### Steps to Add GPUs

1. **Click "Add GPU"**
   * Navigate to the **GPUs page** and select the **Add GPU** button.
2. **Run the Setup Script**
   * Copy the **private setup script** displayed on your portal.
   * Execute the script on the GPU(s) you wish to import.

{% hint style="success" %}
**Rename GPUs for Easier Identification** *(Recommended)*

The script ends with "Aethir" as the default placeholder for your GPU name. You may change this to a custom name for easier identification. If left unchanged, the GPU name will default to "Aethir GPU \[GPU Type]"\
\
When adding multiple servers, renaming them is recommended for easier identification during the subsequent process.
{% endhint %}

3. **Refresh the GPU List**
   * Click **Refresh** to view newly onboarded GPUs.
4. **Check the Onboarding Status**
   * GPUs will display one of the following statuses:
     1. **Preparing Environment**: Script is running to prepare the environment.
     2. **System Check in Progress**: System health check is ongoing.
     3. **Additional Info Required**: IP detection failed; click the GPU entry to manually input the IP.
     4. **Check Failed**: System health check failed; click the GPU entry for error details.
     5. **Staking Pending**: GPU is ready for [staking](/aethir-cloud/aethir-cloud-host/cloud-host-portal-guide/manage-stakings.md).
     6. **Staked**: GPU is staked and generating income.

### GPU Details

Click on the GPU entry to view detailed information.

#### Modifying GPU Details

* **Change Name**: Click the name field and enter a new name (max 64 characters).
* **Change IP Address** *(Only if status is "Additional Info Required")*: Enter the new IP and confirm by pressing **Enter**.

#### GPU Status

* **Online**: Successfully onboarded. No further actions required.
* **Offline**: GPU has been detected as offline.
  * Ensure the network is accessible with the correct IP.
  * Reboot the server if necessary.
  * Ensure the bmagent downloaded during onboarding is running (Do not remove it).
  * Contact [**Support**](/aethir-cloud/support.md) if the issue persists.

#### Order Status

* **Reserved**: GPU has been rented by a Cloud Tenant.&#x20;
  * Rewards and Service Fees are both earned!
* **Idle**: GPU is available and not currently rented.
  * Only Rewards are earned.

### Modifying or Maintaining GPUs

* **Hardware modifications are not allowed after staking is completed.**
* **Maintenance or modifications may result in penalties** and affect active rental orders.
* If maintenance is necessary, contact [**Support**](/aethir-cloud/support.md) before making changes.

{% hint style="warning" %}
**Changing the MAC Address Requires Restaking!**

Be cautious when modifying the network configurations of your GPU. Changing the **Network Interface Card (NIC)** will alter the **MAC address**. This will generate a **new Compute ID (CID)**, requiring **re-staking**.
{% endhint %}

### Removing GPUs

* Only non-staked or unstaked GPUs can be removed.
* **Steps to remove GPUs:**
  1. Select the GPUs to remove.
  2. Click **Remove** and confirm in the popup window.
