Telepresence is a tool that connects your local development workstation to a remote Kubernetes or OpenShift cluster, enabling you to code and debug services locally while they receive real traffic from the cluster.
The tool solves the friction of the traditional container build-push-deploy cycle by creating a virtual network interface on your workstation and routing cluster traffic through a traffic-manager deployed in the cluster. It supports four attachment modes: replacing the remote container entirely, intercepting a service port to handle traffic locally, wiretapping to copy traffic for observation, or ingesting just the environment and volumes. Traffic filtering allows you to intercept only your own requests using HTTP headers or paths, enabling multiple developers to share a single cluster without interfering with each other. The traffic-agent that handles this routing can be injected as a sidecar or run as a node-hosted pod, with the latter option avoiding pod modifications and restarts.
Teams building microservices on Kubernetes should consider Telepresence if they want to preserve their local development experience—using their own IDE, debugger, and hot reload—while testing against a real cluster. It is particularly valuable for developers who need to debug services that depend on other cluster services or who want to test with production-like configurations without the overhead of repeated container builds. The tool works with both standard Kubernetes and OpenShift clusters, and supports running code with the remote container's environment variables and volume mounts so behavior matches what happens in the cluster.
The project maintains active community engagement through GitHub Discussions and a dedicated Slack channel. Development is sponsored and receives contributions from multiple parties. The codebase is written primarily in Go and includes comprehensive documentation covering architecture, quick-start guides, and troubleshooting resources.
