Connecting to an SSH Service using the web portal offers a variety of ways to connect to your remote device using SSH. You can use a standalone SSH client application such as PuTTY, or command-line scripts, depending on your Operating System.


These instructions will show you how to use the web portal to connect a Windows 10, macOS or Linux computer via SSH using a terminal window (or Windows command prompt).

Works With:

  • Devices: All devices running an SSH server.

  • Clients: Windows 10 command prompt, macOS terminal and Linux console or terminal window.

Connect to a SSH Service

See instructions for making connections using the Web Portal

Click on the link of the SSH Service you wish to connect to.

Within a few moments, you will see a dialog with connection details.


We have supplied some pre-formatted ssh command lines using the pi and root usernames for your convenience.

If you are using a different username, use the third option where we’ve inserted the word LOGIN as a place holder for you to enter your own username.

Use the proxy address and port in your SSH command line

Select the entire line and copy it to your terminal or command prompt (don't hit ENTER yet). Now edit the word "LOGIN" (you'll need to use the left arrow and then backspace over it) and replace it with your username. The example shows the username as “ubuntu”.


Now press “Enter”. This initiates the login. You will probably see the following security message (or something similar), which is entirely normal. Type "yes" when prompted to continue with login.

The authenticity of host '[]:35136 ([]:35136)' can't be established. 
ECDSA key fingerprint is SHA256:Gg2MC6laKkCs5PbY4Y1IVVlrZA7eJbSHI4kOz7T0kp4. Are you sure you want to continue connecting (yes/no)?
Type “yes” to accept the new SSH key into your key cache.

Enter your password when prompted.

Now you are logged in and can run console commands as you normally would.


Suppressing SSH security warnings

When you connect to an SSH Service using the proxy address from the web portal or the /device/connect API endpoint, you will get a new URL periodically and so it may not make sense to either check the host authenticity or to save the host details in the known hosts list.


Some people prefer to see all security warnings. If you'd rather see all security warnings, then don't use these options.

In order to suppress the authenticity warning and prevent saving of the URL in the known hosts file, add the following flags to your SSH command line:

-o "StrictHostKeyChecking=no" 
-o "UserKnownHostsFile /dev/null"

The sample command line becomes:

ssh -l root -p 35136 -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile /dev/null"

You will still see a message that the hosts file got updated. However we told the command to send that information to /dev/null rather than the actual known hosts file.

Warning: Permanently added '[]:32076,[]:32076' (ECDSA) to the list of known hosts.

If you run the ssh command again, you will see the same warning, indicating that in fact the host name was not written to the actual known hosts file.

Was this article helpful?
0 out of 0 found this helpful