These are the instructions on how to install and configure your Teleport SSH access on Windows 10 and 11 using MobaXterm to connect to ECMWF services such as the Atos HPCF and ECS services.

Check the following pages if you are using another Windows method:

Teleport SSH Access - Windows Terminal and Powershell configuration

Teleport SSH Access - Windows Subsystem for Linux (WSL)

Teleport SSH Access - Windows Cygwin configuration

Table of Contents

Demo

Here is a demonstration on how to set up Teleport to connect to our our Atos HPCF from your terminal on a Windows 10 or 11. You can find the step by step guide described below.

Installing the tsh client

The tsh application is required to perform user authentication.

tsh is open source, very portable, and has minimal dependencies.

Go to the Teleport website and make sure you download the "tsh client" instead of "Teleport Connect" for Windows.

You will need to extract the zip file and put the "tsh.exe" executable somewhere in your PATH. The easiest way to do this is to:

  1. Open the zip file in your file browser
  2. Drag the teleport folder inside the file and drop into the directory of your choice (the main directory for your user, for example)

  3. Open MobaXterm and start a local terminal. 

  4. Add to the PATH variable the location of the teleport directory. For example, if you dropped it on your main user directory (C:\Users\yourwindowsuser):

    echo 'export PATH=/drives/c/Users/yourwindowsuser/teleport:$PATH' >> ~/.bashrc
source ~/.bashrc


Please be aware that you must use a version of "tsh" equal to or lower than 13. We are working on removing this limitation in the very near future


Authenticating yourself

The following commands need to be run on a MobaXterm local terminal

Setup your SSH config

We strongly recommend setting up all the SSH options needed for the connection instead of passing them on the command line.

Edit the file ~/.ssh/config in your MobaXterm local terminal and add the snippet below. You may create it if it does not exist. You should replace ecmwfusername by your registered ECMWF user and user.address@somewhere.com by your registered email address at ECMWF.

Now you should make the tsh internal directory where SSH certificates are generated visible within MobaXterm running the following command on a MobaXterm local terminal:

ln -s /drives/c/Users/yourwindowsuser/.tsh ~/


SSH connection

The following commands need to be run on a MobaXterm local terminal

Troubleshooting