How to Install RSpace on SURF Research Cloud

Overview

Running RSpace on Research Cloud is ideal for you if you want to experience all the features and benefits of running RSpace in your lab while enjoying easy deployment options in a sovereign local cloud:

Deploy and Update RSpace in a few simple clicks
Low technical maintenance. The RSpace Team pushes config updates and RSpace updates each time you deploy your Workspace
The Research Cloud servers are hosted at the SURF data centre in Amsterdam to ensure data sovereignty

Deploying RSpace on SURF Research Cloud is formed of two main steps. You must create your persistent storage volume first, and then create your Workspace (what SURF calls a VM).

RSpace supports deployment on the SURF High Performance Computing Cloud (SURF HPC Cloud) when deployed on SURF Research Cloud. We are working on having Research Cloud deployments be linked with SURF Research Drive (Nextcloud) out of the box.

The RSpace Catalog item is Invite only right now while we are in the final stages of testing. Please email support@researchspace.com if you'd like to test it out. Alternatively, we'll remove this banner message when it is available to everyone.

Prerequisites

Before you deploy, ensure that you have SSH keys setup with your SURF Research Cloud account.
You will need access to SURF Research Cloud with billing/credits setup. Contact SURF Service Desk if you require a Research Cloud account.

Step 1: Create a storage volume

Do not skip this! You cannot attach storage to a RSpace workspace after it has been created. Get the storage set up first, then come back to deploy RSpace.

Start the storage creation

On the Dashboard, click CREATE NEW in the "Create new storage" card.

Pick your cloud provider and size

Select SURF HPC Cloud volume as the provider. Then choose your storage size. For most RSpace setups 50GB is a reasonable starting point; for this demo, we'll be testing with 10GB.

Click CONTINUE when done.

Give the volume a name

Enter a name you will remember, something like rspace-storage . (For the demo we'll be using the name video-storage-vol). Keep it simple because you will need to reference this later, then click SUBMIT.

Wait for it to be ready

You will be redirected back to your Dashboard. Click the Storage tab and you should see your new volume sitting at State: creating. Give it a few minutes until it switches to State: available.

Step 2: Deploy RSpace

Start a new workspace

Back on the Dashboard, click CREATE NEW under "Create new workspace". The page will load a list of catalog items.

Choose RSpace from the list

Scroll down to find RSpace and hit SELECT.

Choose your cloud provider and VM size

SURF HPC Cloud and Ubuntu 24.04 will be pre-selected. For the VM size, 2 Core - 16 GB RAM works fine for most uses. If you are expecting heavy load, pick something larger. Click CONTINUE.

Attach your storage volume

Last chance! This is the only point where you can attach storage to the RSpace instance (see Step 1: Create a storage volume above). Once the workspace is created, you cannot add it later.

Click SELECT next to the Storage option. A small dialog will pop up showing your available volumes. Find the one you just created and click SELECT next to it. The dialog will close and the volume name will appear in the summary panel on the right.

The storage picker dialog, showing the volume from Step 1

Fill in the final details

Set an expiration date for the workspace (it will automatically shut down on this date - If you plan to use RSpace for a while, set this as a date 1 or 2 years in advance). Give it a name and a hostname, both without spaces. You can use hyphens in the name, but not in the hostname.

Scroll down a little and you will see a Workspace parameters section with a warning box. There is one required field: Enter storage volume name. Type in the exact name of the volume you created in Step 1. It has to match exactly, so copy it carefully.

There is also an option to deploy a specific version of RSpace. This is optional and by default you will always fetch the latest stable version of RSpace when deploying RSpace on SURF Research Cloud, however there are cases where you might want to run a specific version. In this case, go to our GitHub Releases area and find the version number you want. Enter the version number in the box following the format: 2.19.0 (numbers and dots only).

Before clicking Submit, check the summary panel on the right. It should show:

Catalog item: RSpace
Cloud provider: SURF HPC Cloud, Ubuntu 24.04, your chosen size
Options: your storage volume name
Your workspace name, hostname, and expiration date

If everything looks right, click SUBMIT.

Wait for the workspace to come up

You will be redirected back to the Dashboard. Your new workspace will appear under the Workspaces tab showing State: creating. Give it a few minutes. Once it is running, you can access RSpace. It usually takes 5-10 minutes for the Workspace to boot up.

You will see an ACCESS button, if you click that, it will take you to the RSpace login page in a new tab. You can log into RSpace using the default sysadmin credentials found here. Change the password as soon as you login.

If you click the drop down, you will see details about your VM, like the hostname, IP address and SSH details. If your instance fails to boot up, you can download the detailed logs for your Workspace.

If you have any questions about this guide, please email support@researchspace.com!