> 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 Nuvolos logo at the top of the screen.
2. Click the + (plus) icon next to the Spaces list, or click the **+ SPACE** button in the Recent Spaces section at the bottom of the Dashboard.
3. Decide which type of Space to create - **course**, **project**, or **dataset** and from the dropdown menu, select the required type.
4. Fill in the details:
   * Provide a name and description for your space,
   * Select the space visibility 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 dashboard or the spaces list from the left sidebar.
2. From the left sidebar, click the More options menu (⋯) next to the selected space name.
3. Select **Delete Space**.
4. 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).