> 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/how-to-provide-aethir-earth-ai.md).

# How to Provide Aethir Earth (AI)

To participate in Aethir Cloud, Cloud Hosts must onboard their GPU servers by registering them to the platform and staking ATH tokens.

### Register Servers

Before you begin, make sure your servers meet all [**Operation Requirements**](/aethir-cloud/aethir-cloud-host/operational-requirements-for-cloud-hosts.md), including the **Approved GPU Server Locations** and **Server Specifications Requirements**. Contact [**Support**](/aethir-cloud/support.md) if you need special considerations.

#### How to Register

1. Go to **Aethir Earth > Servers**.
2. Click **Add New Server**.
3. Copy the **Setup Script** provided (linked to your Host account).
4. Replace the placeholder name "**Aethir**" at the end of the script with a custom name - preferably the server's **MAC address** (use hyphens for readability).
5. Run the script on the target server(s).
6. Return to the portal and click **Refresh** to see the imported servers.

<figure><img src="/files/gE5v2yZX6JsUs9F8Yzfk" alt=""><figcaption><p>Aethir Earth - Add Servers</p></figcaption></figure>

#### Verify Server Details

* Check that the **Public Ingress IP and Port** are correct. Incorrect info may result in [**Slashing penalties**](/aethir-cloud/aethir-cloud-host/operational-requirements-for-cloud-hosts/slashing-mechanism.md).
* Select the correct **Spec Type**. If it’s missing from the dropdown, contact [**Support**](/aethir-cloud/support.md).
* To remove a server, click **Remove**. Refresh the page to undo the action if needed.

<figure><img src="/files/DXdjfwd1jGty1hR7GdEV" alt=""><figcaption><p>Aethir Earth - Confirm Servers</p></figcaption></figure>

#### **Confirm and Add**

Click **Confirm and Add** to complete the onboarding. You will be redirected to the **Server List** page. The onboarded servers will be shown as **Checking** for machine verification—this may take up to 24 hours.

<figure><img src="/files/vKHsfmaJJsxO8XW7fVny" alt=""><figcaption><p>Aethir Earth - Servers in Checking</p></figcaption></figure>

### Stake Servers

Once your servers pass verification, their status changes to **Waiting for Staking**.&#x20;

**Make sure the hardware is final—any changes will require re-onboarding and re-staking.**

#### How to Stake

1. Go to **Aethir Earth > Servers**.&#x20;

   <figure><img src="/files/3t0eHIA1esl9Eunc9ePp" alt=""><figcaption><p>Aethir Earth - Servers in Waiting for Staking</p></figcaption></figure>
2. Click **Stake** next to the server you want to activate.
3. Review the details and click **Approve**.&#x20;

   <figure><img src="/files/4uq8PCpTSMeG8UzZoVSQ" alt=""><figcaption><p>Aethir Earth - Stake Server</p></figcaption></figure>
4. Sign the transaction in your crypto wallet.

{% hint style="warning" %}
You must use the **same wallet** for all future transactions. **Ensure you’ve selected the correct one before signing.**
{% endhint %}

Once staked, your servers become active and start [**earning**](/aethir-cloud/aethir-cloud-host/rewards-and-service-fees-for-cloud-hosts.md) based on their computational performance and uptime stability.

#### How to Unstake

1. Go to **Aethir Earth > Servers**.&#x20;
2. Click **Unstake** next to the server you want to deactivate.
3. Review the details and click **Approve**.&#x20;
4. Sign the transaction in your crypto wallet.

### **Manage Servers**

After your servers are onboarded, you can monitor and manage them through the **Servers** page. This includes tracking their status, performance, and configuration.

<figure><img src="/files/obMDnIuC49J1vBE7FQjw" alt=""><figcaption><p>Aethir Earth - Servers</p></figcaption></figure>

#### Server Status

Each server displays a status reflecting its onboarding stage and health:

<table data-header-hidden><thead><tr><th width="149.0703125">Status</th><th>Description</th></tr></thead><tbody><tr><td><strong>Confirming Specification</strong></td><td>Setup script executed. Awaiting user confirmation of IP, port, and server specs.</td></tr><tr><td><strong>Checking</strong></td><td>Server details confirmed. Platform is verifying accessibility and configuration.</td></tr><tr><td><strong>Waiting for Staking</strong></td><td>Server passed verification. Awaiting user staking.</td></tr><tr><td><strong>In Service</strong></td><td>Server successfully onboarded. No further action needed.</td></tr><tr><td><strong>Offline</strong></td><td>Server is currently unreachable.</td></tr></tbody></table>

{% hint style="info" %}
**Why Are My Servers Offline?**

1. Check if the network is accessible with the correct IP addresses. Reboot the server if needed.
2. Make sure the bm-agent downloaded during onboarding is running. **Do not remove the bm-agent.**
3. If the issue persists, contact [**Support**](/aethir-cloud/support.md).
   {% endhint %}

**Server Details**

Click **Details** next to any server to view full configuration info.

<figure><img src="/files/WARJZHR4F04SfTeobUav" alt=""><figcaption><p>Aethir Earth - Servers Details</p></figcaption></figure>

* You can edit the **Server Name**. If not updated, it defaults to the Server ID.
* **IP address changes** are allowed only if the server is not in an active rental. Contact [**Support**](/aethir-cloud/support.md) to make changes.

{% hint style="warning" %}
**Changing the MAC address** (e.g., by adding or swapping the NIC) will generate a new Server ID, requiring **re-onboarding and re-staking**.
{% endhint %}

#### Modify or Maintain Servers

* **Hardware modifications** are **not allowed** after staking is completed.
* Any maintenance or modifications may lead to [**slashing**](/aethir-cloud/aethir-cloud-host/operational-requirements-for-cloud-hosts/slashing-mechanism.md) **penalties** and may impact active rental orders for **Cloud Customers**.
* If special circumstances require maintenance, please contact [**Support**](/aethir-cloud/support.md) for assistance.