> For the complete documentation index, see [llms.txt](https://docs.create-magento-app.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.create-magento-app.com/v1/getting-started/getting-started.md).

# Getting Started

Create a new CMA instance in minutes

## Summary

* [ ] Make sure you have Node v12 or newer
* [ ] Install `create-magento-app` dependencies
* [ ] Initialize app with `create-magento-app`
* [ ] Enter the app's directory
* [ ] Start up the app with `npm start`

## Install Dependencies

**You’ll need to have Node >= 12 on your local development machine** (but it’s not required on the server). You can use [n](https://www.npmjs.com/package/n) (macOS, Linux) or [nvm-windows](https://github.com/coreybutler/nvm-windows#node-version-manager-nvm-for-windows) to switch Node versions between different projects.

In addition, before setting up, make sure you have installed the **libraries required to build the PHP**. Also, make sure to install **Docker** and **PHPBrew** in your system. See more in the detailed guides below:

{% content-ref url="/pages/-MOVwpsWQzCvRc9jcPL8" %}
[Linux requirements](/v1/getting-started/prerequisites/installation-on-linux.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MOVx1PztQ7aSC\_MXO2i" %}
[MacOS requirements](/v1/getting-started/prerequisites/installation-on-macos.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MbpJWmV3cwn0JVn5fvs" %}
[Windows requirements](/v1/getting-started/prerequisites/windows-requirements.md)
{% endcontent-ref %}

## Creating an App

To create a new app, you may choose one of the following methods:

{% tabs %}
{% tab title="NPX" %}

```bash
npx create-magento-app my-app
```

{% endtab %}

{% tab title="NPM" %}

```
npm init magento-app my-app
```

{% endtab %}

{% tab title="Yarn" %}

```
yarn create magento-app my-app
```

{% endtab %}
{% endtabs %}

Running any of these commands will create a directory called `my-app` inside the current folder. Inside that directory, it will generate the initial project structure and install the transitive dependencies. Learn more:

{% content-ref url="/pages/-MOWYsDpr9cLMyMxtSOj" %}
[Folder structure](/v1/getting-started/folder-structure.md)
{% endcontent-ref %}

## Running the App

To start the app, navigate to its directory and run the `start` command:

```
cd my-app
npm start
```

This command will start Docker services, start Magento and open your app in the browser.

Create Magento App choose an available port for Magento 2 so it can vary. By default, it will use port 80 so the URL for the store will be <http://localhost:80/>.

### ScandiPWA setup and Theme Linking

If you plan to use the ScandiPWA theme, you have to do the [ScandiPWA setup](https://docs.create-scandipwa-app.com/getting-started/getting-started) and then come back to this CMA guide to do the theme linking:

{% content-ref url="/pages/-MO\_vUfSeKHDP-fbkXSh" %}
[Linking a Scandi Theme](/v1/usage-guide/themes.md)
{% endcontent-ref %}