> 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="/files/64hBE7Nyl2OI3xk2OQaO" 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="/files/VBLDYTvaZLbLqcWU0803" 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="/files/4uuL2CLBK8PCv1hr5fJ6" 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="/files/ePbFwQywqDEEcmFomZRT" 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="/files/DOkvebkiKNMMGX2HfkBB" 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="/files/mChBpiolQEIN1pgEv4eA" alt=""><figcaption></figcaption></figure>