# Installing Teleport on macOS

This guide explains how to install Teleport on macOS.

For an overview of Teleport installation methods and supported platforms, see [Installation](https://goteleport.com/docs/installation.md).

## Operating system support

| Operating System     | `teleport` Daemon | `tctl` Admin Tool | `tsh` and Teleport Connect User Clients \[1] | Web UI (via the browser) | `tbot` Daemon |
| -------------------- | ----------------- | ----------------- | -------------------------------------------- | ------------------------ | ------------- |
| macOS 12+ (Monterey) | yes               | yes               | yes                                          | yes                      | yes           |

\[1] *`tsh` is a Command Line Client (CLI) and Teleport Connect is a Graphical User Interface (GUI) desktop client. See [Using Teleport Connect](https://goteleport.com/docs/connect-your-client/teleport-clients/teleport-connect.md) for usage and installation*.

*For best results, Teleport clients (tsh, tctl, tbot) should be the same major version as the cluster they are connecting to. Teleport servers are compatible with clients that are on the same major version or one major version older. Teleport servers do not support clients that are on a newer major version. See our [Upgrading](https://goteleport.com/docs/upgrading.md) guide for more information.*

## Installing Teleport

**Teleport Enterprise (Managed)**

You can download one of the following .pkg installers for macOS:

| Link                                                                          | Binaries                                                             |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`teleport-ent-18.7.3.pkg`](https://cdn.teleport.dev/teleport-ent-18.7.3.pkg) | `teleport`<br />`tctl`<br />`tsh`<br />`tbot`<br />`fdpass-teleport` |

You can also fetch an installer from the command line:

```
$ curl -O https://cdn.teleport.dev/teleport-ent-18.7.3.pkg
Install on Macintosh HD
$ sudo installer -pkg teleport-ent-18.7.3.pkg -target /
Password:
installer: Package name is teleport-ent-18.7.3
installer: Upgrading at base path /
installer: The upgrade was successful.
$ which teleport
/usr/local/bin/teleport
```

**Teleport Enterprise (Self-Hosted)**

You can download one of the following .pkg installers for macOS:

| Link                                                                          | Binaries                                                             |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`teleport-ent-18.7.3.pkg`](https://cdn.teleport.dev/teleport-ent-18.7.3.pkg) | `teleport`<br />`tctl`<br />`tsh`<br />`tbot`<br />`fdpass-teleport` |

You can also fetch an installer from the command line:

```
$ curl -O https://cdn.teleport.dev/teleport-ent-18.7.3.pkg
Install on Macintosh HD
$ sudo installer -pkg teleport-ent-18.7.3.pkg -target /
Password:
installer: Package name is teleport-ent-18.7.3
installer: Upgrading at base path /
installer: The upgrade was successful.
$ which teleport
/usr/local/bin/teleport
```

**Teleport Community Edition**

You can download one of the following .pkg installers for macOS:

| Link                                                                  | Binaries                                                             |
| --------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`teleport-18.7.3.pkg`](https://cdn.teleport.dev/teleport-18.7.3.pkg) | `teleport`<br />`tctl`<br />`tsh`<br />`tbot`<br />`fdpass-teleport` |

You can also fetch an installer via the command line:

```
$ curl -O https://cdn.teleport.dev/teleport-18.7.3.pkg
Installs on Macintosh HD
$ sudo installer -pkg teleport-18.7.3.pkg -target /
Password:
installer: Package name is teleport-18.7.3
installer: Upgrading at base path /
installer: The upgrade was successful.
$ which teleport
/usr/local/bin/teleport
```

---

DANGER

We do not recommend using Homebrew to install Teleport. The Teleport package in Homebrew is not maintained by Teleport and we can't guarantee its reliability or security.

---