# New instance

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

## 1. Step - Select instance template

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

<figure><img src="/files/0GTWpNs6OzgaRATtx2XT" alt=""><figcaption></figcaption></figure>

You can select one of three templates available:

* Luma - Latest Magento with Luma theme.
* Hyva - Latest Magento with Hyva theme.
* ScandiPWA - Magento 2.4.7 with ScandiPWA 6.4.0.

## 2. Step - Enter instance details

<figure><img src="/files/KGTta8rkIbC4vHpzkMZg" alt=""><figcaption></figcaption></figure>

* **Instance Prefix** - You can use suggested prefixes or enter your own: `uat`, `stage-1`, `test-2` and e.t.c.
* **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
* Magento mode - allows to set up Magento in "production" or "default" mode. Refer to the [official Magento documentation](https://experienceleague.adobe.com/docs/commerce-operations/configuration-guide/setup/application-modes.html) to learn more.

## 3. Step - Review and create instance

<figure><img src="/files/b9FcAdYvwUf4T39yPqXC" alt=""><figcaption></figcaption></figure>

This is the last step before the instance is created. Verify that the settings are correct and click the **Create Instance** button.

## Magento with Hyva

<figure><img src="/files/PFeDePSbPor8T8YnHyil" alt=""><figcaption></figcaption></figure>

To create an instance from Magento 2 Instance with Hyva Template, you will need to provide the **Hyva License Key** and the **Hyva Composer Repository**.

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


---

# Agent Instructions: 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://help.readymage.com/project-management/project-settings/instances/new-instance.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.
