How does it work?


Teleconsole is built on top of Gravitational 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: