Docsright arrowTelepresenceright arrowInstalling the Telepresence Traffic Manager Golden Path

2 min • read

Installing the Telepresence Traffic Manager Golden Path


Telepresence requires a Traffic Manager to be installed in your cluster, to control how traffic is redirected while intercepting. The Traffic Manager can be installed in two different modes, Single User Mode and Team Mode.

Single User Mode is great for an individual user that has autonomy within their cluster and won't impede other developers if they were to intercept traffic. However, this is often not the case for most developers, you often work in a shared environment and will affect other team members by hi-jacking their traffic.

We recommend installing your Traffic Manager in Team Mode. This will default all Intercepts created to be a Personal Intercept. This will give each Intercept a specific HTTP header, that will only reroute the traffic containing the header. Thus working best in a team environment.


Installing the Traffic Manager in Team Mode is quite easy.

If you install the Traffic Manager using the Telepresence command you can simply pass the --team-mode flag like so:

If you use the Helm chart directly, you can just set the mode variable.

Or if you are upgrading your Traffic Manager you can run:

Key Learnings

  • Team mode is essential when working in a shared cluster to ensure you aren't interrupting other developers workflows
  • You can always change the mode of your Traffic Manager while installing or upgrading