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.
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 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"
Next Steps