CLI Tools

Telekube uses the following CLI commands:

Command Description
tele Telekube CLI client. tele is used for packaging Application Bundles and publishing them into the Ops Center.
tsh Telekube SSH client which can be used to remotely connect to a node inside of any Telekube Cluster. tsh is fully compatible with OpenSSH's ssh.
gravity The Kubernetes runtime engine. It manages Kubernetes daemons and their health, Cluster updates and so on. Gravity is present on every machine of a Telekube Cluster.

The typical Telekube workflow is as follows:

  • Start by building and publishing your Application Bundle with tele command. Once a Telekube Cluster is deployed, tele command will let you list the active Clusters.
  • Connect to any server inside of any Cluster using the tsh command.
  • Manage the Cluster from within by using gravity command and/or Kubernetes tools like kubectl.


tele is the Telekube CLI client and can run on macOS and Linux. By using tele on your laptop you can:

  • Package Kubernetes applications into self-installing tarballs ("Application Bundles").
  • Publish Applications Bundles into the Ops Center.
  • Manage the Telekube Clusters in the Ops Center.

See more details in Packaging & Deployment section.


tsh is the SSH client used by Telekube and can run on macOS and Linux. You can use tsh to remotely login into any server in a Telekube Cluster, even those located behind firewalls. To achieve this, tsh uses the Ops Center as an "SSH bastion" or "jump host".

The tsh tool is a part of Gravitational Teleport, an open source SSH server and client developed and supported by Gravitational. Teleport can be used outside of Telekube, but the supplied tsh client is tighly integrated with other Telekube tools, for example tele login.

See more details in Remote Management section


gravity only runs on Linux and is only available on the target machines where your application is running. It can be used to manage the state of a Telekube Cluster.

See more details in Cluster Management section