> For the complete documentation index, see [llms.txt](https://microway.gitbook.io/hpc-test-drive/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://microway.gitbook.io/hpc-test-drive/logging_in/cli_login.md).

# Command Line Logins

These instructions will set up your secure, encrypted connection to Microway's Test Drive cluster. We use industry-standard SSH.

Before continuing, ensure that your account exists. You should have received an e-mail which includes the following information:

* your **username**
* your **password**

The login instructions vary depending upon which operating system you use. Select the operating system you use on your laptop/desktop:

* [Linux](/hpc-test-drive/logging_in/cli_login.md#logins-from-linux)
* [MacOS](/hpc-test-drive/logging_in/cli_login.md#logins-from-macos)
* [Windows](/hpc-test-drive/logging_in/cli_login.md#logins-from-microsoft-windows)

## Logins from Linux

All distributions of Linux come pre-installed with a command line client. You'll be able to access this tool from the list of applications. On most distributions, the tool is called *Terminal* or *Console*.

![](/files/-LP6GEcBhCtPDT-QlGXg)

One you have opened the terminal window, type:

```
ssh -p 30007 username@gateway.microway.com
```

On the line above, **ensure you have changed** `username` to the name you were given when you signed up for the account. The system will then ask for your password.

Once entered correctly, you'll receive a welcome message and can begin work. From this window, you can execute interactive and batch jobs on the compute nodes.

## Logins from MacOS

MacOS comes pre-installed with a command line client. You'll be able to access this tool from the Launchpad menu.

![](/files/-LP6GEcNfKAlHX-GTtkf)

![](/files/-LP6GEcPXqRWc9j15iO4)

![](/files/-LP6GEcRb1d6dQtRqoQ-)

![](/files/-LP6GEcT-65MIW2Wu9PT)

One you have opened the terminal window, type:

```
ssh -p 30007 user@gateway.microway.com
```

On the line above, **ensure you have changed** `user` to the name you were given when you signed up for the account.

![](/files/-LP6GEcYWUSsATg3_IqK)

![](/files/-LP6GEc_dFZcolEBRpkj)

![](/files/-LP6GEcbIGoJFR9BMLU2)

Once the password has been entered correctly, you'll receive a welcome message and can begin work. You will see a command-line prompt which looks like:

![](/files/-LP6GEcdfnRIbN3TNZSR)

From this window, you can execute interactive and batch jobs on the compute nodes.

## Logins from Microsoft Windows

Windows does not include an encrypted shell client, so you will need to download and install a client. We recommend PuTTY:\
1\. Download the installer:

```
https://the.earth.li/~sgtatham/putty/latest/w64/putty-64bit-0.74-installer.msi
```

1. Click to run the installer

![](/files/-LP6GEcfm-18P6rG6q07)

![](/files/-LP6GEchVG3smHs35WFl)

![](/files/-LP6GEcjSy7GSmuCRq9G)

![](/files/-LP6GEcl58qo0BrFi7Tr)

![](/files/-LP6GEcnyczME3OXIW-h)

![](/files/-LP6GEcpUCjg_00WhBE5)

![](/files/-LP6GEcrE2lXprn8rSSO)

![](/files/-LP6GEctHt-sPl4lkDEt)

One you have opened the PuTTY window, enter the `Host Name` and `Port`:

```
gateway.microway.com

30007
```

![](/files/-LP6GEcvr_Nnbfb1m1bq)

Although there are other settings are available, you will not need to change them.

![](/files/-LP6GEcxi53bWpf7yHeP)

![](/files/-LP6GEcz9KDfCWraYFKB)

![](/files/-LP6GEd00miaRk9eJzrw)

On the line above, **ensure you have changed** `user` to the name you were given when you signed up for the account.

![](/files/-LP6GEd29wPK8HPtkWM4)

![](/files/-LP6GEd4hOgDzSWoRbc-)

From this window, you can execute interactive and batch jobs on the compute nodes.

\[1]: MacOS power users may prefer the more advanced terminal application [iTerm2](http://iterm2.com/)