Skip to content
Local development against a remote Kubernetes or OpenShift cluster
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Turn off the new jobs and move them down Jun 11, 2019
.github Update PR template with info about CI Jun 10, 2019
.towncrier Update Towncrier config to point to new repo Jun 12, 2018
ci Don't use an ancient version of kubectl in CI Jun 19, 2019
docs Prep changelog for release 0.101 Jun 19, 2019
environments testbench: Temporarily work around Debian breakage Dec 4, 2018
examples/guestbook Change to https Aug 30, 2017
k8s-proxy Switch to telepresence user if unpriv running as root Jun 6, 2019
local-docker Merge pull request #940 from lminaudier/don-t-use-fqdn-in-local-docker Apr 1, 2019
newsfragments Prep changelog for release 0.101 Jun 19, 2019
packaging Batch packaging pulls Jun 10, 2019
telepresence Increase vpn-tcp sshuttle connect timeout Jun 19, 2019
tests Appy also-proxy tests only to the vpn-tcp method Jun 19, 2019
tools Check Dockerfile for license Dec 13, 2018
.dockerignore Initial testbench support Dec 4, 2018
.gitattributes .gitattributes: Mark *.min.js files as "binary" Dec 18, 2018
.gitignore Initial testbench support Dec 4, 2018
.style.yapf Avoid ugly split dictionary key/value pairs Jun 10, 2019 Add top-level files pointing to content in the docs tree Dec 12, 2017 Add top-level files pointing to content in the docs tree Dec 12, 2017 Add top-level files pointing to content in the docs tree Dec 12, 2017 Update governance doc (WIP), mention it in maintainers doc Jun 5, 2018
LICENSE Initial import of Twisted SOCKS server. Mar 13, 2017 add lukeshu Nov 21, 2018 Install Versioneer Jun 4, 2018
Makefile Switch to venv Jun 10, 2019 Use consistent spelling Oct 31, 2018
dev-requirements.txt Stop using pylint Dec 13, 2018 Homebrew's conflation of Python2 and Python3 continues to be a dumpst… Apr 1, 2019
gcloud-service-key.circleci.json.enc Re-encrypt gcloud service key for Datawire CircleCI. Jan 19, 2018
gcloud-service-key.travisci.json.enc Add helpers for working with the encrypted gcloud service key. Jan 18, 2018 Remove references to now-unused teleproxy Jan 24, 2019
pylintrc Run pylint on k8s-proxy using local pylintrc May 15, 2018
pyproject.toml Make output look a little closer to what's there now Apr 3, 2018
setup.cfg Specify test paths in setup.cfg; include k8s-proxy too Dec 5, 2018 Make sure setuptools installs new subpackages Aug 2, 2018 Fix some typos in code Mar 4, 2019

Documentation - start here!

Build Status Join the chat at CII Best Practices



Telepresence: fast, realistic local development for Kubernetes microservices

Have you ever wanted the quick development cycle of local code while still having your code run within a remote Kubernetes cluster? Telepresence allows you to run your code locally while still:

  1. Giving your code access to Services in a remote Kubernetes cluster.
  2. Giving your code access to cloud resources like AWS RDS or Google PubSub.
  3. Allowing Kubernetes to access your code as if it were in a normal pod within the cluster.

Quick Start

  1. Install locally with Homebrew, apt, or dnf.

  2. Run telepresence.

  3. You now have a shell that proxies connections to Kubernetes.

For more about Telepresence, and the various options, read the documentation.

Usage Reporting

Telepresence collects some basic information about its users so it can send important client notices, such as new version availability and security bulletins. We also use the information to aggregate basic usage analytics anonymously. To disable this behavior set the environment variable SCOUT_DISABLE:


To know more, check the documentation on usage reporting.

About Telepresence

Telepresence is an open source project hosted by the Cloud Native Computing Foundation and originally created by Datawire. Telepresence is licensed under the Apache 2.0 License.

You can’t perform that action at this time.