# Space management

Learn how to create, configure, and manage your [spaces](/features/nuvolos-basic-concepts/organisational-hierarchy.md#spaces) in Nuvolos.

{% hint style="info" %}
Only organisation managers and faculty members can create spaces.
{% endhint %}

## 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](#clone-a-github-repository) 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.

{% hint style="success" %}
**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](/help-and-reference/faqs.md#is-git-supported) to get started.
{% endhint %}

{% hint style="warning" %}
**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).
{% endhint %}

**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

{% hint style="danger" %}
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.**
{% endhint %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuvolos.com/administration/space-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.