Skip to content
Using Telepresence to debug in-cluster services

Using Telepresence to debug in-cluster services

Telepresence connects your local machine to the cluster network so a local process can intercept traffic meant for a service running in-cluster.

Prerequisites

  • Having telepresence client installed (OSS version).
  • A working kubeconfig for the cluster (either OIDC or AAdmin).
  • The traffic manager must already be deployed on the cluster.

Connect

(Optional) Use the correct context:

kubectl config use-context __ENV__

Connect to the cluster:

telepresence connect

This routes cluster-internal DNS and IPs through your local machine, so you can reach in-cluster services (e.g. curl my-service.my-namespace:8080) directly.

Disconnect

telepresence quit

Notes

  • Only one telepresence connect session is active per machine at a time.
  • Intercepts affect the shared cluster — only intercept services you’re actively debugging, and disconnect when done.