# Telepresence-oss

Telepresence-oss is a self-hosted development app. Helm chart that deploys the Telepresence server-side components into a Kubernetes cluster, enabling developers to debug local services against real cluster traffic without the container build-and-deploy cycle. It is open source and self-hosted, installable on Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/7306/telepresence-oss

## Description

Helm chart that deploys the Telepresence server-side components into a Kubernetes cluster, enabling developers to debug local services against real cluster traffic without the container build-and-deploy cycle.

## Platform availability

Available on 3 of 9 platforms: Helm, Mac, Windows.

## Desktop and other devices

Mac, Windows.

## Health score

80/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 2 days ago)
- Popular: 77 (7,321 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)

## Links

- Kubernetes (Helm): https://artifacthub.io/packages/helm/telepresence-oss/telepresence-oss
- GitHub: https://github.com/telepresenceio/telepresence
- Official website: https://www.telepresence.io
- desktop: https://github.com/telepresenceio/telepresence/releases/latest

## Common questions

### Do I need to install a local Telepresence client to set up or connect the cluster?

Yes. Install the Telepresence client with Homebrew on macOS or the provided RPM package on Fedora/RHEL. Without it, you will not have the Telepresence commands needed to set up or connect to the cluster.

### Is it safe to rerun the Telepresence cluster setup command?

Yes. telepresence setup --apply installs the traffic-manager controller that routes cluster traffic to your local containers. The documentation says the command is safe to run again.

### Why are cluster services unreachable from my machine after setup?

You may need to run telepresence connect --namespace default to create the network path that lets your machine reach cluster services. If you skip it, cluster services will not be reachable.

### What common Telepresence issues should I check when debugging local development?

The troubleshooting guide covers cluster connections, DNS, volume mounts, and traffic-agent injection.

### Where can self-hosters get community support for Telepresence issues?

Use the community GitHub Discussions and the CNCF Slack channel for telepresence-oss. The project also points to troubleshooting documentation for common issues.

---
Source: Our Local Host (https://ourlocalhost.com/app/7306/telepresence-oss), the self-hosted and open-source app directory.