Connect Client

Availability

Stage

Experimental

Requires

You can use the Teleport Connect client or the tsh CLI tool to access your Kubernetes clusters managed by Teleport.

Prerequisites

Teleport Connect installed on your machine or tsh CLI tool installed. Refer to the Client Installation guide for installation instructions.
kubectl installed on your machine. You can download it from the official Kubernetes documentation.
You must be in a Teleport Role that has been granted access to the Kubernetes clusters you want to connect to.

Open the Teleport Connect application from your applications menu or desktop shortcut.

Use the Teleport Connect interface to log in to your Teleport cluster using your credentials.

Once logged in, search for the Kubernetes cluster you want to access and click on Connect to open an interactive shell.

Now you can use kubectl commands to interact with your Kubernetes cluster:

kubectl get pods
kubectl get services

Use the tsh login command to log in to your Teleport cluster:

tsh login --proxy=<your-teleport-proxy> --user=<your-username> --auth=local

Use the tsh kube ls command to list all available Kubernetes clusters you have access

tsh kube ls

Use the tsh kube login command to access a specific Kubernetes cluster:

tsh kube login <kube-cluster-name>

Now you can use kubectl commands to interact with your Kubernetes cluster:

kubectl get pods
kubectl get services