Skip to content

How it Works

This introduction section is intended to give a high-level overview of the ShellHub.


Click here to view large image

There are few basic concepts that are important to understand the ShellHub. Those basic concepts are detailed below:

SSH Gateway

The SSH gateway is a SSH server which forward connections to the devices running ShellHub's agent.


An internet-connected device, such as a computer or something more specific like a single-board computer, running ShellHub's agent.


ShellHub's agent which must be installed on the device.


SSHID is a unique address to identify a device in the SSH gateway, which must be specified in the following format:



  • <NAMESPACE>: Is the account namespace identifier
  • <HOSTNAME>: Is the device hostname identifier
  • <SERVER_ADDRESS>: Is the ShellHub server instance address identifier

Example of SSHID: