Client Installation
There are multiple way to interact with Teleport, including a web-based user interface and a command-line interface (CLI) tool called tsh. This guide will walk you through the installation of the tsh client on various operating systems.
Teleport Connect
Teleport Connect is a desktop application that provides a graphical interface for accessing your infrastructure and resources. It is available for Linux, Windows, and macOS.
Download Teleport Connect
Visit the Teleport Connect download page and download the installer for your operating system.
Ensure that Teleport Connectis selected from the dropdown menu on the download page.
Install Teleport Connect
Follow the installation instructions specific to your operating system:
- Windows: Run the downloaded installer and follow the on-screen prompts.
- macOS: Open the downloaded
.dmgfile and drag the Teleport Connect application to your Applications folder. - Linux: Extract the downloaded archive and run the installation script provided.
Launch Teleport Connect
Open the Teleport Connect application from your applications menu or desktop shortcut.
tsh CLI
The tsh CLI tool allows you to connect to your Teleport-managed resources from the command line.
It includes features such as:
tsh login- Authenticate to the Teleport cluster.tsh ssh- Connect to SSH servers managed by Teleport.tsh db- Connect to databases managed by Teleport.tsh kube- Access Kubernetes clusters managed by Teleport.tsh status- View the status of your Teleport connections.
Follow the official Teleport documentation for detailed installation instructions for your specific operating system.