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 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"

Next Steps