Skip to main content

Telepresence

Telepresence is an open-source developer tool (Kubernetes development workflow) that lets engineers connect a local development environment to a remote Kubernetes cluster for fast inner-loop testing of services running in the cluster.

  • Local-to-remote service connectivity for Kubernetes workloads (Kubernetes development workflow).
  • Traffic interception from a remote Kubernetes service to a local process for live development and debugging (service routing).
  • Support for developing and testing individual microservices against a shared remote cluster while preserving cluster dependencies (microservices development).
  • Integration with existing Kubernetes tools and workflows such as kubectl and standard manifests (Kubernetes tooling integration).
  • Secure connectivity between developer machines and clusters using a Telepresence client, traffic manager, and agents (secure connectivity).

More About Telepresence

Telepresence is an open-source tool (Kubernetes development workflow) designed to connect a developer’s local workstation to a remote Kubernetes cluster so that local code can run as if it were deployed inside the cluster. The project targets teams building microservices on Kubernetes that need to iterate on individual services while still relying on shared cluster resources such as APIs, data stores, and other dependencies.

The core capability of Telepresence is local-to-remote service bridging (service routing), which allows a developer to run a service locally while intercepting traffic that would normally go to a pod in the cluster. Telepresence redirects this traffic from a Kubernetes service or deployment to the developer’s machine, enabling testing of code changes against real cluster dependencies without building container images or redeploying. This model supports rapid inner-loop development workflows for microservices applications.

Telepresence uses a client, traffic manager, and in-cluster agents (secure connectivity) to establish the link between the local environment and the Kubernetes cluster. The developer runs a Telepresence client on the workstation, which connects to a traffic manager component running in the cluster. The traffic manager coordinates with lightweight agents deployed alongside targeted workloads to route requests and environment details, such as environment variables and volumes, to the local process. This architecture preserves Kubernetes service discovery and networking behavior while executing application logic on the local machine.

In enterprise environments, Telepresence supports development against shared staging or testing clusters (microservices development) so teams can collaborate on large applications without each developer needing a full local replica of the environment. Engineers can debug services using familiar local tools, Integrated Development Environments (IDEs), and debuggers while still interacting with cluster-level services such as ingress controllers, service meshes, and managed databases. The tool integrates with standard Kubernetes credentials and access controls (security and access management), allowing organizations to align Telepresence usage with existing authentication and authorization practices.

Telepresence interoperates with standard Kubernetes APIs and command-line tools (Kubernetes tooling integration). Developers typically use kubectl contexts to target clusters, and Telepresence operates within that context, working with Kubernetes objects such as deployments, services, and namespaces. The project is part of the Cloud Native Computing Foundation (open-source foundation), which aligns it with other CNCF ecosystem projects focused on container orchestration and cloud-native application delivery.

For directory classification, Telepresence fits into categories such as Kubernetes development workflow, microservices development tooling, and service routing for local/remote debugging. It provides a mechanism for connecting developer machines to running cluster workloads in a controlled manner, which supports iterative development, troubleshooting, and testing of services within enterprise Kubernetes environments.