> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/knowledge-base/tenants/sharing-a-vm-into-a-tenant.md).

# Sharing a VM into a Tenant

VergeOS provides an easy way to share a virtual machine (VM) image from a parent environment into a tenant located beneath the current environment. Follow these steps to accomplish the task:

## Steps to Share a VM

1. **Navigate to the VM Dashboard**:
   * Go to the VM dashboard of the VM you want to move into a tenant.
2. **Gracefully Power Down the VM**:
   * It is best practice to gracefully power down the VM using the guest operating system's best practices before moving it.
3. **Take a Snapshot**:
   * In the VM dashboard, expand **Snapshots** in the left navigation menu to access the snapshot commands.
   * Click **Take Snapshot** to launch the **Machine Snapshot** creation screen.
4. **Complete the Snapshot Creation**:
   * At the Machine Snapshot creation screen, fill in the required fields:
     * **Machine**: The virtual machine you are moving.
     * **Name**: Provide a unique name for the snapshot.
     * **Expiration Date**: Set the date/time when the snapshot will automatically be deleted.
   * Click **Submit** to create the snapshot.
5. **Share the VM Snapshot**:
   * After clicking **Submit**, you will be taken to the dashboard of the newly created snapshot.
   * From this view, click on **Share VM** in the left navigation menu to launch the **Shared Objects** creation screen.
6. **Create the Shared Object**:
   * At the **New Shared Objects** creation screen, fill in the required fields:
     * **Name**: Name the snapshot of the VM something unique.
     * **Type**: Select **Virtual Machine**.
     * **Snapshot**: This should match the name provided during the snapshot creation.
     * **Recipient**: Select the tenant where you want to share the VM.
   * Click **Submit** to create the shared object.
7. **Access the Tenant Environment**:
   * Using a web browser, navigate to the tenant environment where the snapshot object was shared.
   * Log in with the proper authentication credentials.
8. **Create a New Virtual Machine in the Tenant**:
   * In the tenant environment, navigate to **Machines** > **Virtual Machines**, and click **New** to begin creating a new virtual machine.
9. **Import from Shared Objects**:
   * At the **New Virtual Machine** creation screen, under **Select Type**, choose **-- Import from Shared Objects --**.
   * In the **Selections Available** section, select the shared object created earlier, then click **Next**.
10. **Complete the Virtual Machine Settings**:
    * On the **Virtual Machine Settings** screen, complete the required fields:
      * **Shared Objects**: Select the shared object created earlier.
    * Click **Submit** to create the new virtual machine in the tenant.

***

***

{% hint style="info" %}
**Document Information**

* Last Updated: 2024-08-29
* vergeOS Version: 4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.vergeos-demo.com/knowledge-base/tenants/sharing-a-vm-into-a-tenant.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.