> 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](https://docs.nuvolos.com/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. Choose the Space type: **Course**, **Research Project**, or **Dataset**.
4. Complete **Space details**:

* Enter the required name and short description. The name must be unique within the Organisation.
* Select the visibility (**Private** is the default).
* For a Course, confirm the required **Space archival date**, which defaults to eight months after creation.

5. Under **Initial content**, choose one of these mutually exclusive options:

* **Add README** - create an otherwise empty Space and initialise it with a `README.md` file.
* **Create space based on a template** - copy an existing Space of the same type where you are a Space Administrator, or [clone a GitHub repository](#clone-a-github-repository).

6. Click **Add Space**, or **Clone Space** when copying an existing Space.

When finished, you land in the new Space. To add software, open **Applications** in the Master Instance and click **+ Application**.

### 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](https://docs.nuvolos.com/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. Select **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.

## Manage Space and Instance roles

Space administrators can manage a direct Space member's roles across the Space from one dialog.

1. Open the More options menu (**⋯**) next to the selected Space name and select **Users**.
2. Find a direct Space member, open the More options menu next to their name, and select **Assign roles**.
3. Search across the Space and its Instances.
4. Select the required changes. You can promote the member to Space Administrator; assign or change Editor, Viewer, or Observer roles on multiple Instances; or revoke existing Instance roles.
5. Click **Apply changes**.
6. Review the Results tab for the outcome of each selected change.

The Users page shows direct Space members by default. Turn on **Inherited roles** to include Organisation Managers, and expand a direct member to inspect their Instance roles. Inherited roles are not editable from the Space because they must be changed at their source.

## 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](https://docs.nuvolos.com/administration/instance-management.md).
* To track how a Space consumes NCUs, storage, and Credits, see [Administration › Resource monitoring](https://docs.nuvolos.com/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](https://docs.nuvolos.com/concepts/nuvolos-basic-concepts.md).
