> 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/instance-management.md).

# Instance management

## Create a new instance

{% hint style="info" %}
**Important notes:**

* Only space administrators can create new Instances.
* Instances support two permission types: Instance Editor and Instance Viewer. Make sure the correct role is granted at creation. Learn more about [instance-level roles](https://docs.nuvolos.com/concepts/roles-secrets-and-identity/roles.md#instance-level-roles).
  {% endhint %}

**To create an instance:**

1. Navigate to the space where you want to create the instance.
2. Click the **+** (plus) icon next to the Instances list to create a new Instance.
3. Choose whether to start from a snapshot or create an empty instance.
4. Fill in the instance name and description. Both can be modified later.

### **Create a shared Instance and invite collaborators**

1. Open your space (course or research project).
2. From the sidebar, click the More options menu (⋯) next to the selected Space name, choose **Invite Users**.
3. Select **User invitation** and **Invite to a shared instance**, then click **+ INSTANCE**.
4. Choose between creating an empty instance or one with snapshot contents, then click **CONTINUE**.
5. Enter a name and description for your instance, then click **+ INSTANCE**.
6. Choose the role to invite users with - collaboration generally requires the **Editor** role.

   Learn more about [instance-level roles](https://docs.nuvolos.com/concepts/roles-secrets-and-identity/roles.md#instance-level-roles).
7. Enter the email addresses and click **INVITE**.

## Edit an instance

{% hint style="info" %}
**Important notes:**

* Instance Editors and space administrators can edit instance names and descriptions.
* Master and Distributed instances cannot be changed - the names and descriptions are both fixed for these.
* Both name and description fields have a maximum length of 1023 characters.
  {% endhint %}

**To edit an instance:**

1. Navigate to the space where you want to edit the instance.
2. Open the **INSTANCES** tab.
3. Locate the Instance in the list, click the More options menu (⋯) and select **Edit**.
4. Edit the name and description. The Instance name must be unique within the Space.
5. When done, click **SAVE CHANGES**.

The changes will take effect immediately, and the instance list will refresh to show the updated information.

## Delete an instance

{% hint style="info" %}
**Important notes:**

* Only space administrators can delete instances.
* The Master and Distributed Instances can't be deleted - remove the entire Space if you need to clear them.
  {% endhint %}

To delete an instance:

1. Navigate to the space where you want to edit the instance.
2. Open the **INSTANCES** tab.
3. Locate the Instance in the list, click the More options menu (⋯) and select **Delete**.
4. Read the warning, tick **I understand**, and click **DELETE**.

## Invite users to an existing instance

To invite users to an existing instance:

1. Navigate to the space containing the instance.
2. Go to the **Instances** tab, find your Instance, open its More options menu (**⋯**), and select **Invite users**.
3. Select **User invitation**. The existing Instance is selected automatically.
4. Choose whether to invite Instance Editors or Instance Viewers.
5. Enter the email addresses and click **INVITE**.

## Review and manage instance members

Space administrators can review membership directly from the **Instances** table:

1. Expand an Instance row to list its visible members and roles.
2. Turn on **Inherited members** to include access inherited from Space Administrator or Organisation Manager roles. This filter is off by default.
3. Open the More options menu (**⋯**) for a direct member to change or revoke their Instance role.

Inherited access has no action menu because it cannot be changed at the Instance level. Change or revoke it at the Organisation or Space where the role was granted.

#### **Where to go next**

* To set up snapshots, distribute content, or recover an Instance from a previous state, see [How-to › Shared workflows › Snapshots](https://docs.nuvolos.com/how-to-guides/common-workflows/snapshots.md) and [How-to › Shared workflows › Distribution mechanic](https://docs.nuvolos.com/how-to-guides/common-workflows/object-distribution.md).
* To monitor how Instances consume storage within a Space, see [Administration › Resource monitoring](https://docs.nuvolos.com/administration/monitoring-resource-usage.md).
* If you want to understand the difference between current states and snapshot states, and why Instances are versioned the way they are, see [Concepts › Snapshots, distribution, and states](https://docs.nuvolos.com/concepts/distribution.md).
