Teleport TSH
Teleport · The Teleport command-line client for authenticated access to protected infrastructure, SSH sessions, file transfer and session playback.
Teleport TSH is Networking software for Mac.
About
Teleport TSH (tsh) is a command-line client for accessing resources protected by a Teleport cluster. It is not a standalone macOS graphical application or an SSH server. Users authenticate through a Teleport proxy and use the terminal to connect to infrastructure, inspect resources and interact with sessions.
Client workflow
The official CLI reference covers cluster login, listing resources, SSH access, file copying and working with current or recorded sessions. Teleport provides certificate-based access controls, while the client lets users work within permissions granted by their cluster. Available resource types and commands depend on the installed client version, cluster configuration and edition.
Recorded version
This catalog entry is the legacy Homebrew tsh cask at version 16.4.7, distributed as tsh-16.. The official 16.4.7 release adds tsh resolve for OpenSSH Match-exec configurations and support for a -- delimiter in tsh ssh. It also fixes idle-time skipping in tsh play and an error with older U2F authenticators.
Maintenance warning
Homebrew marks this exact cask deprecated and disabled as unmaintained and names teleport as its replacement. This listing describes the recorded legacy package; it does not imply that version 16.4.7 is a current supported client. Use official installation guidance and a client compatible with your cluster when planning a new installation. The current online CLI reference covers a newer major version, so not every documented command applies to this package.
Sources
New What’s new in 16.4.7 Nov 12, 2024 · OpenNavo editorial
- tshAdds resolve for OpenSSH Match exec configurations.
- PlatformFixes Kubernetes recording duplication and several Web UI issues.
Install and uninstall
Homebrew runs the tsh-16.4.7.pkg installer, which asks for an administrator password.
Install without Homebrew
Download the same file Homebrew uses: cdn.teleport.dev/tsh-16.4.7.pkg
SHA-256 only checks that the download is complete; it is not a security certification. See the SHA-256 and download address
$ brew uninstall --cask tshA regular uninstall removes the app and keeps its settings and caches.
$ brew uninstall --zap --cask \tsh--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left.See which files are removed
Facts and sources
- Version 16.4.7
- Recorded by Homebrew on Nov 12, 2024Released by the vendor on Nov 12, 2024
Questions
Is Teleport TSH safe?
Homebrew has disabled Teleport TSH (it is no longer maintained), so it can no longer be installed with Homebrew. It was disabled on Nov 18, 2025.
Is Teleport TSH open source?
Teleport TSH’s source code is public on GitHub (gravitational/teleport) under the AGPL-3.0 license.
How do I completely uninstall Teleport TSH on a Mac?
Run brew uninstall --cask tsh. It forgets 1 installer receipt. To delete its settings and caches as well, run brew uninstall --zap --cask tsh. That also deletes ~/.
Does Teleport TSH run on Apple silicon (M1 and later) Macs?
Homebrew installs it on both Apple silicon and Intel Macs, from the same download.
Where does Teleport TSH store its settings and data?
Its data is in ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of Teleport TSH?
The latest version is 16.4.7, added to Homebrew on Nov 12, 2024. Run brew upgrade --cask tsh to update it.
What else does installing Teleport TSH add?
It installs through a .pkg installer, which asks for an administrator password. It cannot be installed alongside teleport-suite and teleport-suite@17.