> ## Documentation Index
> Fetch the complete documentation index at: https://gcore-doc-1256a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage a Virtual GPU cluster

After [creating a Virtual GPU cluster](/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster), use the cluster details page to monitor nodes, manage power state, configure disks and network interfaces, and delete cluster resources.

## Access cluster details

To view and manage an existing cluster, open the cluster details page.

1. In the [Gcore Customer Portal](https://portal.gcore.com), navigate to **GPU Cloud**.
2. Select **Sines-3** region.
3. In the sidebar, expand **GPU Clusters** and select **Virtual GPU Clusters**.
4. Click on a cluster name to open the details page.

The page is organized into tabs: **Overview**, **Volumes**, **Networking**, **Power**, **Tags**, **User Actions**, and **Delete**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1256a/e_kdmrPf_7tHYRYR/images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/cluster-instances-overview.png?fit=max&auto=format&n=e_kdmrPf_7tHYRYR&q=85&s=fcb040ab444d04403b5c347258af24c7" alt="Cluster details page with Overview tab showing cluster instances" width="1494" height="560" data-path="images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/cluster-instances-overview.png" />
</Frame>

## Manage cluster power state

Virtual GPU clusters support power management operations at the cluster level. Unlike Bare Metal clusters, powering off a Virtual GPU cluster releases compute resources (shelving), which stops billing but also removes data from local disks.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1256a/e_kdmrPf_7tHYRYR/images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/power-management.png?fit=max&auto=format&n=e_kdmrPf_7tHYRYR&q=85&s=e97907d0e0532d059e4e56634e29f274" alt="Power tab with Power on, Power off, Soft reboot, and Hard reboot options" width="1270" height="802" data-path="images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/power-management.png" />
</Frame>

### Power off (shelve) a cluster

Powering off a Virtual GPU cluster shelves all nodes. Shelving releases CPU, RAM, GPU, and local disk resources. No charges apply while nodes are shelved.

1. In the cluster list or cluster details page, locate the cluster.
2. Click the **Power Off** action.
3. Confirm the operation.

<Warning>
  **Warning**

  When a node is shelved, the local data disk is deleted and all data on it is lost. Only network disks persist. Save important data to network disks or external storage before powering off.
</Warning>

### Power on a cluster

Powering on a shelved cluster attempts to allocate resources for all nodes.

1. In the cluster list or cluster details page, locate the powered-off cluster.
2. Click the **Power On** action.

<Warning>
  **Warning**

  Restart is not guaranteed after shelving. If the requested resources (GPU model, flavor) are not available in the region at the time of power on, the operation fails. For workloads requiring guaranteed availability, use Bare Metal clusters.
</Warning>

## Manage node disks

After cluster creation, disks can be managed individually for each node. This allows adding storage to specific nodes or removing unused disks.

### Add a disk to a node

1. Navigate to the cluster details page.
2. Open the **Volumes** tab.
3. Select the node to attach a disk to.
4. Click **Add Volume** and configure the disk type and size.
5. Click **Create** to attach the new disk.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1256a/e_kdmrPf_7tHYRYR/images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/volumes-tab.png?fit=max&auto=format&n=e_kdmrPf_7tHYRYR&q=85&s=0fe16b3890f387b1449b0e7e5c5c049f" alt="Volumes tab showing instance volumes with Add Volume button" width="1586" height="342" data-path="images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/volumes-tab.png" />
</Frame>

### Remove a disk from a node

1. Navigate to the cluster details page.
2. Open the **Volumes** tab.
3. Locate the disk to remove and click the detach action.
4. Confirm the operation.

<Warning>
  **Warning**

  Detaching a disk does not delete it. The disk remains in the account and continues to incur storage charges until explicitly deleted.
</Warning>

## Manage network interfaces

After cluster creation, network interfaces can be managed individually for each node through the **Networking** tab on the cluster details page.

### Add an interface to a node

1. Navigate to the cluster details page.
2. Open the **Networking** tab.
3. Click on a node to expand its details.
4. Click **Add Interface**.
5. Configure the **Network type** (**Public**, **Private**, or **Dedicated public**) and IP allocation settings.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1256a/e_kdmrPf_7tHYRYR/images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/add-interface-dialog.png?fit=max&auto=format&n=e_kdmrPf_7tHYRYR&q=85&s=39d1dde9219077193d38f042ce29de69" alt="Add Interface dialog with network type and configuration options" width="439" height="627" data-path="images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/add-interface-dialog.png" />
</Frame>

### Remove an interface from a node

1. Navigate to the cluster details page.
2. Open the **Networking** tab.
3. Click on a node to expand its details.
4. Locate the interface to remove and click the delete action.
5. Confirm the operation.

<Info>
  **Info**

  InfiniBand interfaces cannot be removed or modified. They are managed automatically to ensure inter-node communication.
</Info>

## Delete a cluster

When deleting a Virtual GPU cluster, disks attached to nodes can optionally be preserved.

<Warning>
  **Warning**

  Deleting the last node in a cluster automatically deletes the entire cluster. This applies to both UI and API/Terraform operations. When using the API or Terraform to delete nodes, no warning is displayed before the cluster is removed. Ensure at least one node remains if you want to preserve the cluster.
</Warning>

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1256a/e_kdmrPf_7tHYRYR/images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/delete-cluster-dialog.png?fit=max&auto=format&n=e_kdmrPf_7tHYRYR&q=85&s=b8f9a4b07389f32b22eeb3a529624268" alt="Delete Cluster dialog with volume selection and confirmation" width="1081" height="652" data-path="images/docs/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster/delete-cluster-dialog.png" />
</Frame>

1. In the cluster list or cluster details page, click **Delete**.
2. In the confirmation dialog:
   * To delete all disks along with the cluster, leave the **Delete disks** checkbox selected.
   * To preserve disks for later use, clear the **Delete disks** checkbox.
3. Confirm the deletion.

<Info>
  **Info**

  Preserved disks remain in the account and continue to incur storage charges. They can be attached to other instances or clusters.
</Info>

## Automating cluster management

The [Gcore Customer Portal](https://portal.gcore.com) is suitable for managing individual clusters. For automated workflows—such as CI/CD pipelines, infrastructure-as-code, or batch provisioning—use the GPU Virtual API.

The API allows:

* Starting, stopping, and rebooting clusters
* Managing volumes attached to cluster servers
* Deleting clusters programmatically

The [GPU Virtual API reference](/api-reference/cloud/gpu-virtual) provides endpoint details and code examples.
