> For the complete documentation index, see [llms.txt](https://help.readymage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.readymage.com/project-management/project-settings/instances/new-instance.md).

# New instance

On the **New Instance** page, the Admins and the Owner of the project can create a new instance.

## 1. Step - Select Project

Choose one of the following options:

* **Existing Project** – Select a project that you are a member of to create an additional environment (instance) within that project.
* **New Project** – Create a new project and provision the first instance for it.
* **New Project for Another User** – Create a new project and assign ownership to another user by specifying their **Owner Email**. The specified user will become the project owner.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FUCLLRgOb43oNAX7jYIwP%2Fimage.png?alt=media&amp;token=f26c9e30-657b-4c4f-a742-a29931b0d870" alt=""><figcaption></figcaption></figure>

## 2. Step - Select instance template

{% hint style="warning" %}
Only applicable for the creation of the first instance.
{% endhint %}

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FeWWAj7Nh74DoO2yt8l00%2Fimage.png?alt=media&amp;token=28521bc4-9e8e-4ef9-91d1-7e63045eb2e0" alt=""><figcaption></figcaption></figure>

You can select one of four templates available:

* **Magento Luma** - Latest Magento with Luma theme.
* **Hyva** - Latest Magento with Hyva theme.

  * To create an instance with Hyva Template, you will need to provide the **Hyva License Key** and the **Hyva Composer Repository in** [**Step 3**](#id-3.-step-configure-your-new-instance-settings)**.**

  <figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2F6l2twY9gh5GKSlwW8Wiu%2Fimage.png?alt=media&amp;token=6bcaa54d-02c5-494d-af9b-2d3a6d4f1da4" alt=""><figcaption></figcaption></figure>
* **ScandiPWA** - Magento 2.4.7 with ScandiPWA 6.4.0.
* **No-code** - blank instance.

## 3. Step - Configure your new instance settings.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FbsU4X3NwdqFomKmNxCRM%2Fimage.png?alt=media&amp;token=bf71f727-c630-4ae3-88d3-a6083eb2b8a5" alt=""><figcaption></figcaption></figure>

* **Instance Name** - A human-readable name for this instance.
* **Instance Tag** - You can use suggested prefixes or enter your own: `uat`, `stage-1`, `test-2` and e.t.c.
* **Magento Mode** - allows to set up Magento in `production` , `default` or `developer` mode. Refer to the [official Magento documentation](https://experienceleague.adobe.com/docs/commerce-operations/configuration-guide/setup/application-modes.html) to learn more.
* **Region** - a region your instance will be hosted in. Currently, available regions are:
  * Europe Ireland
  * Europe Stockholm
  * USA Ohio
  * Middle East UAE
  * Canada Central
  * Asia Pacific Sydney
* **Hyvä Credentials** *(Optional)* – This section is displayed only when the **Hyvä** template is selected. Enter the **Repository URL** and **License Key** to enable access to the Hyvä packages.

{% hint style="success" %}
We will verify if the provided **License Key** and **Composer Repository** are valid before proceeding.
{% endhint %}

## 4. Step - Create Instance

This is the final step before the environment is created. Ensure all provided details are correct, then click **Create Instance** to start the environment creation process.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FbH2YjNRJfwpmFwlWi3k6%2Fimage.png?alt=media&amp;token=c31779f1-33e2-423b-86be-040e7a7cdb47" alt=""><figcaption></figcaption></figure>

The instance creation process runs in the background, so you don't need to stay on this page. You can return at any time to monitor its progress.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2F71ohrtJNRqMsR3rgKHp6%2Fimage.png?alt=media&amp;token=62198261-000d-415c-889c-69f6c868589b" alt=""><figcaption></figcaption></figure>
