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 total)
tp cluster create -i ~/.ssh/id_ed25519.pub -t 8xH200 -n 2

# 4-node cluster with 8xB200 each (32 GPUs total)
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 cls_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 cls_abc123
This action is irreversible. Make sure to back up any important data before destroying a cluster.

​
Next Steps

⌘I