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


---

# 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.aethir.com/aethir-cloud/aethir-cloud-host/cloud-host-portal-guide/manage-gpus.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.
