Teleport Unified Access Plane

How does it work?

How does Teleconsole work?

How does it work?


Teleconsole is built on top of Teleport which is a clustered SSH server with a built-in SSH bastion/proxy. 99% of Teleport code is a Golang library. This makes it easy to create interesting SSH projects.

Teleconsole is one of such projects. It is essentially an “instant” SSH server which is pre-configured to trust SSH proxy.

Both projects are open source and hosted on Github.

Creating Session

What happens when you type teleconsole?

  1. It generates unique single-use SSH credentials and launches an SSH server on localhost. Then Teleconsole logs into itself, an equivalent of ssh localhost.
  2. SSH credentials are POSTed via HTTPS to a free anonymous SSH proxy on
  3. The server creates a single-use disposable instance of Teleport SSH proxy, which is trusted by the teleconsole SSH server running on your machine.
  4. Your local teleconsole SSH server creates an outbound SSH tunnel to the disposable Teleport proxy running on The proxy now acts as a bridge connecting the outside world to your machine.

Teleconsole Diagram

Joining Session

And here is what happens when you type teleconsole join session-id:

  • teleconsole requests the proxy for SSH keys for the session via HTTPS.
  • It uses those keys to SSH into the proxy.
  • The proxy forwards the connection through the tunnel created in step 3 to your machine.

Gravitational Teleconsole

Teleconsole is a free service to share your terminal session with people you trust. Your friends can join via a command line via SSH or via their browser over HTTPS. Use this to ask for help or to connect to your own devices sitting behind NAT.

Teleconsole on Github

Teleconsole is open sourced under the Apache 2.0 license. Teleconsole binaries are available for Linux, OSX and FreeBSD.

View Teleconsole On Github

This site uses cookies to improve service. By using this site, you agree to our use of cookies. More info.