Space management

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

Only organisation 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 (Private is the default option),

   • (Optional) Initialize the space from GitHub or another space,

   • (Optional) Add a README.md file,

   • 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 the Master instance of your new space:

   • Click SKIP THIS STEP to skip

   • Or navigate the application marketplace to find the application yu want to add.

   • Click + INSTALL 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.

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.

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

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

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 — 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.