Skip to content

Accessing the TRE

To access the RE you will need to install an AWS client, set up two-factor authentication with Okta and login using the credentials sent by Genomics England.

This guide takes you through getting access to the RE for the first time, including:

  • Installing an AWS client
  • Adding the RE WorkSpace to AWS
  • Logging in
  • Setting up two-factor authentication
  • Logging out

If you have any issues with access, please take a look at our FAQs.

Install an AWS client

Amazon WorkSpaces are virtual machines you can access on the web. To use them, you need to install a client, a free software application which can be downloaded online.

Install an AWS client

Choose the appropriate version for your operating system, click download and follow the prompts to install.

Add the RE WorkSpace to AWS

To add the workspace, you will need an access code in the form wslhr+######. This will have been sent to you by email when you registered.

You will need to launch your AWS client.

If this is the first time you have used AWS and you don't have any other workspaces set up, you will see a dialogue box where you can input the access code you have been sent:

Then click Register.

If you already have your AWS client installed with other workspaces you access, you will need to add the RE as a new workspace.

  1. When you launch your AWS client, you will reach the login screen for your other workspace. Click on Change Registration Code.

  2. Here you will see a drop-down where you can select from existing workspaces. This is also a text box where you can overwrite the code with the access code you have been sent.

    Then click Register.

  3. Use Change Registration Code when you open AWS to select the correct workspace.

Give your workspaces nicknames

If you have multiple workspaces, you may find it easier to give your workspaces nicknames.

  1. Go into Settings then Manage Login Information.

  2. Here you can add nicknames, making it easier to choose your workspace when you login in future.

Set up two-factor authentication

Login to the RE requires two-factor authentication (2FA) with the Okta Verify app. You can do this on your smartphone or on your computer.

  1. Go to and put in your username and password.

  2. Install the Okta Verify app on your smartphone. You can find this in the App Store or Google Play.

  3. Open your app and scan the QR code on your computer screen.

  4. You will now see a six-digit code in your Okta app listed under, with your username. This code refreshes every 30 seconds. You will use this code every time you login.

  1. Download the Authy app and install it on your desktop.

  2. Open the app and input your Genomics England username and password.

  3. Go to and put in your username and password.

  4. Choose Can't scan? at the QR code, then navigate through to get to an Okta Verify unique secret key code.

  5. In your Authy app, you should see an option or plus sign to Add an account, then add the secret key code.

  6. The next page will provide you with a list of different app accounts, please scroll through and select the Okta option (the token code length can be kept to six-digits) and click Save.

  7. You will now see a six-digit code in your Authy app listed under, with your username. This code refreshes every 30 seconds. You will use this code every time you login.

Login to the TRE

From here you can login. Use your GEL username (not your email address) and password. The 'MFA Code' refers to the six-digit code that refreshes every 30 seconds in your two-factor authentication app.

The workspace will now launch, it can a couple of minutes to load.

Logging out

To log out of the RE, click on System at the bottom left of the screen:

If you select Log Out, you will be able to log back in straight away. However if you select Shut Down, there will be a delay of several minutes before you can log back in.

Video tutorial

Last update: November 27, 2023