Space management

Learn how to create, configure, and manage your spaces in Nuvolos.

Note: Only organization managers and faculty members can create spaces.

Create a new space

Follow these steps to create your space:

1. Navigate to the dashboard view by clicking the home icon in the breadcrumbs at the top of the screen.

2. Decide which type of space you want to create: course, research project, or dataset.

   • For a course, select courses from the left sidebar

   • For a research project, select research projects

   • For a dataset, select datasets

3. Let's say you want to create a course: click the school hat icon in the sidebar to view your list of courses, then click "NEW COURSE" in the top right.

4. Fill in the details:

   • Provide a name and description for your space

   • Select the space type

   • Optionally, initialize the space from GitHub or another space

   • When ready, click ADD SPACE (In this example, we're creating a private course called "Demo class")

5. You'll see an optional step asking if you want to create an application in your new space:

   • Click "SKIP THIS STEP" to skip

   • Or create an application now (In this example, we're creating an RStudio application with R 3.6.1 called "Demo RStudio")

   • Click "ADD APPLICATION" to continue

6. Finally, you'll land on a page where you can choose your next action: add files, open your new application, or invite users.

Creating a course

Clone an existing space

Want to create a new space based on an existing one? The 'Clone an existing space' feature lets you use any space as a template for your new space. The Current State of the Master instance from your template will be cloned to the new space's Master instance. Access privileges, snapshots, and other instances won't be copied over.

Here's how to clone a space:

First, enter a name and description for your new course, then select the resource pool. Click the 'Create space based on a template' switch to activate this feature:

Creating space based on a template

Click the 'Clone an existing space' dropdown to search for the space you want to use as a template. Important: You need to be a space administrator in a space to select it as a template. Once you've entered all the required information, click the 'Clone space' button:

Select the space to be used as a template

Note: When creating a space from a template, space visibility and readme files aren't customizable during creation—they'll be automatically copied from the template to your new space.

Your space will be created immediately, but the cloning process happens in the background. You can track its progress under User Notification/Tasks.

Clone a GitHub repository

Creating a new space? You can initialize it by cloning a repository from Github.com. Both public and private repositories are supported.

Using SSH URLs? If you want to use SSH URLs (git@...), you'll need to set up SSH access from Nuvolos to GitHub first—even for public repositories. Follow our SSH setup guide to get started.

HTTPS vs. SSH: You can use an HTTPS URL if you only need to pull from a public repository. However, if you plan to push commits to the remote, we recommend SSH URLs (HTTPS will repeatedly ask for your username and password).

To clone a GitHub repository:

Click the 'Create space based on a template' switch to reveal additional options:

Cloning a Github.com repository

Select 'Clone a Github repository' and enter or paste the URL for the repository you want to clone.

The space is ready to be created

Click the 'Add Space' button to create your space. You can then add applications as usual. The initialization process happens in the background—depending on the repository size, it may take a few minutes to complete. Track its progress in the 'Tasks' section under 'User notifications'.

Once cloning finishes, you'll find the repository in the root directory of every application in your space.

Delete a space

Important: Only space administrators can delete a space. This action permanently removes all content, including all instances and their data. This operation may impact many users, so proceed with caution.

To delete a space:

1. Open the space from the toolbar breadcrumbs or dashboard. For example, if you want to delete "Demo Space", click it to open the overview.

2. From the left sidebar, hover over the settings icon and select Delete Space.

3. Read the warning message carefully, click "I understand", then click DELETE SPACE.