Skip to main content
Connect to your cluster’s instances over SSH with the tp ssh command.

​
tp ssh

SSH into a running instance. 
tp ssh <instance_id> [ssh_args...]

​
Arguments

ArgumentDescription
instance_idInstance ID to SSH into
ssh_argsAdditional SSH arguments to pass through (e.g. -i, -o, -v)

​
Examples

Connect to an instance: 
tp ssh i-abc123
Connect with a specific SSH key: 
tp ssh i-abc123 -i ~/.ssh/my_key
Connect with verbose output for debugging: 
tp ssh i-abc123 -v
tp ssh requires an instance ID (e.g., i-abc123), not a cluster ID (e.g., c-abc123). A cluster can have multiple instances, so you need to specify which one to connect to. Use tp cluster info <cluster_id> to find the instance IDs for your cluster.
If you save an SSH key to your account with tp me sshkey add, you won’t need to pass -i each time you create a cluster. See account commands for details.

​
Generating SSH Keys

If you don’t have SSH keys, generate them: 
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
This creates:
  • ~/.ssh/id_ed25519 - Your private key (keep secure!)
  • ~/.ssh/id_ed25519.pub - Your public key (used when creating clusters)

​
Next Steps