https://github.com/telepresenceio/telepresence
Local development against a remote Kubernetes or OpenShift cluster
https://github.com/telepresenceio/telepresence
docker kubernetes local-development minikube proxy tunnel vpn
Last synced: 7 days ago
JSON representation
Local development against a remote Kubernetes or OpenShift cluster
- Host: GitHub
- URL: https://github.com/telepresenceio/telepresence
- Owner: telepresenceio
- License: other
- Created: 2017-02-23T14:07:34.000Z (over 9 years ago)
- Default Branch: release/v2
- Last Pushed: 2026-01-16T03:33:31.000Z (5 months ago)
- Last Synced: 2026-01-17T05:31:00.412Z (5 months ago)
- Topics: docker, kubernetes, local-development, minikube, proxy, tunnel, vpn
- Language: Go
- Homepage: https://www.telepresence.io
- Size: 44.1 MB
- Stars: 7,099
- Watchers: 54
- Forks: 563
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.OLD.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE-OF-CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Governance: GOVERNANCE-maintainer.md
- Maintainers: MAINTAINERS.md
Awesome Lists containing this project
- stars - telepresenceio/telepresence
- awesome-platform-engineering - Telepresence - Local development against a remote Kubernetes or OpenShift cluster (Kubernetes / Kubernetes local development)
- toptout - Telemetry details
- awesome-k8s-resources - Telepresence - Telepresence provides fast, realistic local development for Kubernetes microservices. (Tools and Libraries / Development Tools)
- awesome-list-docker - telepresence
- awesome-ops - telepresenceio/telepresence - 02-23|2025-11-07 | 面向远程 Kubernetes 或 OpenShift 集群的本地开发工具 | (K8S-Tools)
- awesome-cloud-native - telepresence - Local development against a remote Kubernetes or OpenShift cluster. (Developer Workspaces & Productivity)
- awesome-starts - telepresenceio/telepresence - Local development against a remote Kubernetes or OpenShift cluster (Python)
README
# Telepresence: Fast, Local Development for Kubernetes
[
](https://telepresence.io)
[](https://artifacthub.io/packages/search?repo=telepresence-oss) [](https://gurubase.io/g/telepresence)
Telepresence is a [CNCF](https://www.cncf.io/) project that connects your local workstation to a remote Kubernetes cluster, letting you run services locally while accessing cluster resources. It enables fast local development without the container build/push/deploy cycle.
## Key Features
- **Local Development** - Run services on your workstation using your favorite IDE, debugger, and tools
- **Cluster Access** - Your local machine can reach cluster services as if it were inside the cluster
- **Traffic Interception** - Redirect traffic from cluster services to your local machine for debugging
- **Fast Iteration** - No waiting for container builds or deployments
## Getting Started
- [Quick Start Guide](https://telepresence.io/docs/quick-start) - Get up and running in minutes
- [Installation](https://telepresence.io/docs/install/client) - Install the Telepresence client
- [Documentation](https://telepresence.io/docs/) - Full documentation
## How It Works
When Telepresence connects to a cluster, it creates a virtual network interface on your workstation and routes traffic through a Traffic Manager deployed in the cluster. This allows your local services to communicate with cluster resources and optionally intercept traffic destined for cluster workloads.
## Community
- [CNCF Slack](https://communityinviter.com/apps/cloud-native/cncf) - Join [#telepresence-oss](https://cloud-native.slack.com/archives/C06B36KJ85P)
- [Troubleshooting](https://telepresence.io/docs/troubleshooting/) - Common issues and solutions
## Contributing
See [CLAUDE.md](CLAUDE.md) for build instructions, architecture overview, and development guidelines.
## License
Telepresence is licensed under the [Apache License 2.0](LICENSE).