Logging In

Once you have an account, you can log into the cluster from any network (internal to QMUL, over eduroam, or from other sites over the internet) using a secure shell (SSH).

We recommend that you use SSH keys to give you secure access to your account. For details on how to set this up please visit our Setting up SSH keys page.

Never share your private key or password with anyone

Your private key / password identifies you as yourself, anyone with either of these can access your account.

SSH Access

Linux SSH

Open a terminal, enter the following command (replacing USERNAME with your username):

ssh USERNAME@login.hpc.qmul.ac.uk

If you have set up SSH keys then you may be asked for your passphrase to unlock your key. Otherwise you will be prompted to enter your password.

Mac OSX SSH

Open Terminal (go to Applications->Utilities->Terminal) Enter the following command (replacing USERNAME with your username):

ssh USERNAME@login.hpc.qmul.ac.uk

If you have set up SSH keys then you may be asked for your passphrase to unlock your key. Otherwise you will be prompted to enter your password.

Your password will not be displayed

Unlike Mac OSX, Linux does not display passwords as they are typed.

Windows SSH

For Windows users, we recommend the use of MobaXterm as it provides interfaces for both SSH and X Windows, which allows you run some GUI software from Apocrita.

Open MobaXterm Enter the following command (replacing USERNAME with your username):

ssh USERNAME@login.hpc.qmul.ac.uk

If you have set up SSH keys then you may be asked for your passphrase to unlock your key. Otherwise you will be prompted to enter your password.

Your password will not be displayed

Unlike Windows, Linux does not display passwords as they are typed.


X Windows

The X windows system allows forwarding of graphical applications running on cluster nodes to the users desktop, this allows programs like MATLAB to be run on the cluster using the GUI. Due to the overhead of running and GUI and the need for a constant connection this is discouraged but may be required by certain applications.

Initial setup varies based on the users operating system.

Linux X Windows

Adding -X to the ssh command line will enable X forwarding:

ssh USERNAME@login.hpc.qmul.ac.uk -X

If you experience issues with drawing the GUI or receive errors it may be worth trying -Y instead of -X which will enable X forwarding without the X11 Security extensions:

ssh USERNAME@login.hpc.qmul.ac.uk -Y

Mac OSX X Windows

Mac OSX uses the same commands as Linux but requires the installation of XQuartz to allow X Windows software to be used.

Windows X Windows

MobaXterm has X windows built in and forwarded by default so no additional user steps are required.


Changing your password

Once you have an account, you should be able to change your Apocrita password using the ITS Research Password Manager. Please make sure that you read the recommendations carefully.

The password change will affect access to the following ITS Research services:

For changing your college password please use central IT Services PRM utility.

Currently you can only access it from the QMUL networks, if you are off site please try one of the following:

  • Set-up SOCKS Tunnel via the login node (login.hpc.qmul.ac.uk)
  • Use VPN if you have access to one

If you cannot remember your password please contact us requesting a one-time unlocking code.

One-time unlocking code

If you were given a one-time unlocking code, please enter it into the One-time unlocking code field leaving the existing password entry blank.