Skip to main content

​
Cluster Commands

Manage your GPU clusters with the tp cluster command group.

​
tp cluster create

Deploy a new GPU cluster. 
tp cluster create -i <public_key_path> -t <instance_type> [options]

​
Required Arguments

  • -i, --public-key - Path to your public SSH key (e.g., ~/.ssh/id_ed25519.pub)
  • -t, --instance-type - Instance type to deploy (see Instance Types)

​
Optional Arguments

  • --name - Custom cluster name
  • -n, --num-nodes - Number of nodes (only supported for 8xH200 and 8xB200 instance types)

​
Examples

# Single H100
tp cluster create -i ~/.ssh/id_ed25519.pub -t 1xH100

# Single node with 8x H200
tp cluster create -i ~/.ssh/id_ed25519.pub -t 8xH200

# Single node with 8x B200
tp cluster create -i ~/.ssh/id_ed25519.pub -t 8xB200

# Single node MI300X
tp cluster create -i ~/.ssh/id_ed25519.pub -t 1xMI300X

# 2-node cluster with 8xH200 each (16 GPUs)
tp cluster create -i ~/.ssh/id_ed25519.pub -t 8xH200 -n 2

# 4-node cluster with 8xB200 each (32 GPUs)
tp cluster create -i ~/.ssh/id_ed25519.pub -t 8xB200 -n 4

​
tp cluster list

View all your clusters. 
tp cluster list [--org]

​
Optional Arguments

  • --org, --organization - List all clusters in your organization

​
Example

# List your clusters
tp cluster list

# List all organization clusters
tp cluster list --org

​
tp cluster info

Get detailed information about a specific cluster. 
tp cluster info <cluster_id>

​
Arguments

  • cluster_id - The ID of the cluster to inspect

​
Example

tp cluster info c-abc123

​
tp cluster destroy

Terminate and delete a cluster. 
tp cluster destroy <cluster_id>

​
Arguments

  • cluster_id - The ID of the cluster to destroy

​
Example

tp cluster destroy c-abc123
This action is irreversible. Make sure to back up any important data before destroying a cluster.

​
tp cluster edit

Edit cluster settings. 
tp cluster edit <cluster_id> [options]

​
Arguments

  • cluster_id - The ID of the cluster to edit

​
Optional Arguments

  • --name - New name for the cluster
  • --deletion-protection - Enable/disable deletion protection (true/false)

​
Example

tp cluster edit c-abc123 --name "new-cluster-name"

​
tp cluster attach

Attach a storage volume to a cluster. 
tp cluster attach <cluster_id> <storage_id>

​
Arguments

  • cluster_id - The ID of the cluster to attach storage to
  • storage_id - The ID of the storage volume to attach

​
Example

tp cluster attach c-abc123 s-xyz789
Storage volumes can only be attached to multi-node clusters (2+ nodes).

​
tp cluster detach

Detach a storage volume from a cluster. 
tp cluster detach <cluster_id> <storage_id>

​
Arguments

  • cluster_id - The ID of the cluster to detach storage from
  • storage_id - The ID of the storage volume to detach

​
Example

tp cluster detach c-abc123 s-xyz789

​
Next Steps