Fork me on GitHub
Teleport

FAQ

Community FAQ

Can I use Teleport in production today?

Teleport has been deployed on server clusters with thousands of nodes at Fortune 500 companies. It has been through several security audits from nationally recognized technology security companies, so we are comfortable with the stability of Teleport from a security perspective.

Can Teleport be deployed in agentless mode?

Yes. Teleport can be deployed with a tiny footprint as an authentication gateway/proxy and you can keep your existing SSH servers on the nodes. But some innovating Teleport features, such as cluster introspection, will not be available unless the Teleport SSH daemon is present on all cluster nodes.

Can I use OpenSSH with a Teleport cluster?

Yes, this question comes up often and is related to the previous one. Take a look at Using OpenSSH client section in the User Manual and Using OpenSSH servers in the Admin Manual.

Can I connect to nodes behind a firewall?

Yes, Teleport supports reverse SSH tunnels out of the box. To configure behind-firewall clusters refer to Trusted Clusters section of the Admin Manual.

Can individual nodes create reverse tunnels to a proxy server without creating a new cluster?

This has been a long standing request of Teleport and it has been fixed with Teleport 4.0. Once you've upgraded your Teleport Cluster, change the node config option --auth-server to point to web proxy address (this would be public_addr and web_listen_addr in file configuration). As defined in Adding a node located behind NAT - Teleport Node Tunneling

Can nodes use a single port for reverse tunnels?

Yes, Teleport supports tunnel multiplexing on a single port. Set the tunnel_listen_addr to use the same port as the web_listen_addr address setting in the proxy_service configuration. Teleport will automatically use multiplexing with that configuration.

What are Teleport's scalability and hardware recommendations?

We recommend setting up Teleport with a High Availability configuration. Below is our recommended hardware for the Proxy and Auth server. If you plan to connect more than 10,000 nodes, please get in touch and we can help architect the best solution for you.

ScenarioMax Recommended CountProxyAuth server
Teleport nodes connected to auth server10,0002x 2-4 vCPUs/8GB RAM2x 4-8 vCPUs/16GB RAM
Teleport nodes connected to proxy server (IoT)2,000*2x 2-4 vCPUs/8GB RAM2x 4-8 vCPUs/16+GB RAM

Which version of Teleport is supported?

Teleport provides security critical support for the current and two previous releases. With our typical release cadence this means a releases is usually supported for 9 months.

ReleaseLong Term SupportRelease DateMin tsh version
6YesMarch 4th, 20213.1
5.0YesNovember 24th, 20203.1
4.4YesOctober 20th, 20203.1
4.3 (EOL)YesJuly 8th, 20203.1
4.2 (EOL)YesDecember 19th, 20193.1
4.1 (EOL)YesOctober 1st, 20193.1
4.0 (EOL)YesJune 18th, 20193.1

How should I upgrade my cluster?

Please follow our standard guidelines for upgrading. We recommend that the Auth Server should be upgraded first, and proxy is bumped after.

Does Web UI support copy and paste?

Yes. You can copy&paste using the mouse. For working with a keyboard, Teleport employs tmux-like "prefix" mode. To enter prefix mode, press Ctrl+A.

While in prefix mode, you can press Ctrl+V to paste, or enter text selection mode by pressing [. When in text selection mode, move around using hjkl, select text by toggling space and copy it via Ctrl+C.

What TCP ports does Teleport use?

Please refer to the Ports section of the Admin Manual.

Does Teleport support authentication via OAuth, SAML or Active Directory?

Gravitational offers this feature for the Enterprise versions of Teleport.

Commercial Teleport Editions

What is included in the commercial version, Teleport Enterprise?

The Teleport Enterprise offering gives users the following additional features:

  • Role-based access control, also known as RBAC.
  • Authentication via SAML and OpenID with providers like Okta, Active Directory, Auth0, etc. SSO.
  • Premium support.

We also offer implementation services, to help you integrate Teleport with your existing systems and processes.

You can read more in the Teleport Enterprise section of the docs

Does Teleport send any data to Gravitational?

The open source edition of Teleport does not send any information to Gravitational and can be used on servers without internet access. The commercial versions of Teleport may or may not be configured to send anonymized information to Gravitational, depending on the license purchased. This information contains the following:

  • Anonymized user ID: SHA256 hash of a username with a randomly generated prefix.
  • Anonymized server ID: SHA256 hash of a server IP with a randomly generated prefix.

This allows Teleport Pro to print a warning if users are exceeding the usage limits of their license. The reporting library code is on Github.

Reach out to [email protected] if you have questions about the commercial edition of Teleport.

Have a suggestion or can’t find something?
IMPROVE THE DOCS