# Install teleport with Homebrew, MacPorts, Nix, zypper, scoop, winget

Modern SSH server for teams managing distributed infrastructure. Version 18.10.0 via Homebrew; verified 2026-07-12. Also installable with nix: nix profile install nixpkgs#teleport.

## Install

```sh
sudo av install brew:teleport
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install teleport
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install teleport
```

  Evidence: MacPorts ports tree: net/teleport/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#teleport
```

  Evidence: nixpkgs package indexes: pkgs/by-name/te/teleport/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install teleport
```

  Evidence: openSUSE Tumbleweed package metadata: teleport from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/teleport
```

  Evidence: Scoop official bucket manifest trees: bucket/teleport.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Gravitational.Teleport -e
```

  Evidence: Windows Package Manager source index: Gravitational.Teleport from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:teleport
- **Package manager:** Homebrew
- **Version:** 18.10.0
- **Source summary:** Modern SSH server for teams managing distributed infrastructure
- **Homepage:** <https://goteleport.com/>
- **Repository:** <https://github.com/gravitational/teleport>
- **Last updated:** 2026-07-12T10:08:53Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- fdpass-teleport (alias)
- sessionhelper (alias)
- tbot (alias)
- tctl (alias)
- teleport (alias)
- teleport-update (alias)
- tsh (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 18.10.0
## Project history and usage

Teleport is an open source access platform for infrastructure. It started around SSH access and grew into a multi-protocol identity, proxy, audit, and access-control system for servers, Kubernetes, databases, applications, desktops, and cloud resources.

### Project history

Teleport's own 2018 release notes say it began as an SSH library built for Gravity, Gravitational's product for managing Kubernetes applications on private clouds. After it was open sourced, users asked for enterprise SSH features such as RBAC and SAML/OAuth2 authentication without needing Gravity.

By Teleport 2.4 in January 2018, the project was already described as a modern SSH and kubectl bastion server with certificate-based authentication, SSO integration, built-in bastion behavior, and session recording. Teleport 3.0 in October 2018 added native Kubernetes support and positioned the proxy as a single authentication endpoint for SSH and Kubernetes.

### Adoption history

Teleport grew from SSH-focused access into a broader platform as teams tried to replace static keys, VPNs, and hand-built bastions. The 2020 Teleport Cloud announcement says Teleport had moved from early adopters to organizations such as NASDAQ, Snowflake, and IBM and had expanded from SSH into Kubernetes and internal application access.

Current docs make the CLI adoption model clear: engineers use `tsh` to authenticate, list resources, connect to servers, proxy applications, connect to databases, and manage sessions, while administrators use Teleport services and `tctl` to enroll and govern resources.

### How it is used

Package users install Teleport for several binaries, especially `teleport` for cluster services, `tsh` for user access, `tctl` for administration, and `tbot` for machine identity. Typical package usage involves generating `/etc/teleport.yaml`, running services under systemd or launch tooling, and storing user certificates under `~/.tsh`.

In package-manager culture, Teleport is a heavy-duty CLI package: upgrades, service definitions, config paths, and client/server version compatibility all matter because the package controls access to production infrastructure.

### Why package nerds care

Teleport is significant because it packages an entire access-control plane into installable binaries. For package maintainers and operators, it sits in the sensitive zone where a package is both a daemon and a security boundary.

The Homebrew formula is especially useful for client-side users who need `tsh` and related tools on laptops, while server packages matter for running auth, proxy, node, Kubernetes, database, and application services.

### Timeline

- 2015: gravitational/teleport repository created.
- 2018: Teleport 2.4 release notes describe the project's open source SSH-server roots and commercial editions.
- 2018: Teleport 3.0 adds native Kubernetes support.
- 2020: Teleport Cloud preview is announced as a hosted way to run Teleport.
- 2026: Teleport 18.9.2 is published in the official GitHub releases.

### Related projects

- Gravity is the Gravitational product whose SSH library origins fed into Teleport.
- OpenSSH and kubectl are the familiar client workflows Teleport integrates with and augments.
- Teleport Connect, tctl, tsh, and tbot are related tools within the same Teleport ecosystem.

### Sources

- <https://github.com/gravitational/teleport>
- <https://github.com/gravitational/teleport/releases/tag/v18.9.2>
- <https://goteleport.com/blog/teleport-2-4-released/>
- <https://goteleport.com/blog/teleport-cloud/>
- <https://goteleport.com/blog/teleport-release-3/>
- <https://goteleport.com/docs/connect-your-client/teleport-clients/tsh/>
- <https://goteleport.com/docs/core-concepts/>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/teleport.yaml

## Credential files

- Unix: ~/.tsh
- Windows: %USERPROFILE%/.tsh
## Other Package-Manager Records

- Nix - teleport: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/teleport/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - teleport - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Identity-aware, multi-protocol access proxy | https://github.com/gravitational/teleport
- zypper - teleport-bash-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for teleport | https://github.com/gravitational/teleport
- zypper - teleport-fdpass-teleport - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-fdpass-teleport from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Significantly reduce resource consumption by large numbers of SSH connections | https://github.com/gravitational/teleport
- zypper - teleport-tbot - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tbot from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CLI tool for Machine ID | https://github.com/gravitational/teleport
- zypper - teleport-tbot-bash-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tbot-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for teleport-tbot | https://github.com/gravitational/teleport
- zypper - teleport-tbot-zsh-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tbot-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for teleport-tbot | https://github.com/gravitational/teleport
- zypper - teleport-tctl - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CLI tool for managing a teleport server | https://github.com/gravitational/teleport
- zypper - teleport-tctl-bash-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tctl-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for teleport-tctl | https://github.com/gravitational/teleport
- zypper - teleport-tctl-zsh-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tctl-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for teleport-tctl | https://github.com/gravitational/teleport
- zypper - teleport-tsh - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tsh from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CLI tool for logging into nodes via Teleport SSH | https://github.com/gravitational/teleport
- zypper - teleport-tsh-bash-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tsh-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for teleport-tsh | https://github.com/gravitational/teleport
- zypper - teleport-tsh-zsh-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-tsh-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for teleport-tsh | https://github.com/gravitational/teleport
- zypper - teleport-zsh-completion - 17.7.26-1.3: normalized package name match | openSUSE Tumbleweed package metadata: teleport-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for teleport | https://github.com/gravitational/teleport
- MacPorts - teleport: normalized package name match | MacPorts ports tree: net/teleport/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/teleport: normalized package name match | Scoop official bucket manifest trees: bucket/teleport.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/teleport.yml](https://github.com/mxcl/pkgdb/blob/main/combined/teleport.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
