> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/administration/space-management.md).

# Space management

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

## Create a new space

Only organisation managers and faculty members can create Spaces.

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 to create - **course**, **research project**, or **dataset.**
3. Click **NEW COURSE / NEW RESEARCH PROJECT / NEW DATASET** button at the bottom of the Dashboard.
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,
   * Click ADD SPACE to confirm.
5. Optionally, choose to create an Application in the Master Instance immediately. Click SKIP THIS STEP to do this later, or browse the catalogue and click + INSTALL to add one now.

When finished, you land on a page where you can add files, open the new Application, or invite users.

### Clone a GitHub repository

You can initialise a new Space by cloning a repository from GitHub. 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](/troubleshooting/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 repository during Space creation:

1. Toggle **Create space based on a template** to reveal additional options.
2. Select **Clone a GitHub repository** and paste the repository URL.
3. Click **Add Space** to create the space. Initialisation runs in the background - depending on the repository size, it may take a few minutes to complete. Track its progress in User notifications → Tasks.

Once cloning finishes, the repository appears in the root directory of every Application in the space.

## Delete a space

Only space administrators can delete a Space. This action permanently removes all content, including every Instance and its data.

{% hint style="danger" %}
**Warning** 

This operation may affect many users. It cannot be undone. Confirm with collaborators before proceeding.
{% endhint %}

To delete a space:

1. Open the space from the toolbar breadcrumbs or dashboard. 
2. From the left sidebar, hover over the settings icon and select **Delete Space**.
3. Read the warning message carefully, tick **I understand**, then click **DELETE SPACE**.

**Where to go next**

* If you have just created a Space and want to add Instances within it, see [Administration › Instance management](/administration/instance-management.md).
* To track how a Space consumes NCUs, storage, and Credits, see [Administration › Resource monitoring](/administration/monitoring-resource-usage.md).
* If you want to understand the model behind Spaces, Instances, and the resource pools that bill them, see [Concepts › The hierarchy and resource model](/concepts/nuvolos-basic-concepts.md).