2 min • read

Client reference

The Telepresence CLI client is used to connect Telepresence to your cluster, start and stop intercepts, and create preview URLs. All commands are run in the form of telepresence <command>.


A list of all CLI commands and flags is available by running telepresence help, but here is more detail on the most common ones.

connectStarts the local daemon and connects Telepresence to your cluster and installs the Traffic Manager if it is missing. After connecting, outbound traffic is routed to the cluster so that you can interact with services as if your laptop was another pod (for example, curling a service by it's name)
loginAuthenticates you to Ambassador Cloud to create, manage, and share preview URLs
logoutLogs out out of Ambassador Cloud
dashboardReopens the Ambassador Cloud dashboard in your browser
previewCreate or remove preview URLs for existing intercepts: telepresence preview create <currently intercepted service name>
statusShows the current connectivity status
quitQuits the local daemon, stopping all intercepts and outbound traffic to the cluster
listLists the current active intercepts
interceptIntercepts a service, run followed by the service name to be intercepted and what port to proxy to your laptop: telepresence intercept <service name> --port <TCP port>. This command can also start a process so you can run a local instance of the service you are intercepting. For example the following will intercept the hello service on port 8000 and start a Python web server: telepresence intercept hello --port 8000 -- python3 -m http.server 8000. A special flag --docker-run can be used to run the local instance in a docker container.
leaveStops an active intercept: telepresence leave hello
uninstallUninstalls Telepresence from your cluster, using the --agent flag to target the Traffic Agent for a specific workload, the --all-agents flag to remove all Traffic Agents from all workloads, or the --everything flag to remove all Traffic Agents and the Traffic Manager.