> 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/getting-started/getting-started.md).

# Getting Started

## 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 Docker! However, if you don't know or don't want to set it up manually, for Linux and macOS systems Docker installation is automated! Windows WSL2 systems will need to install Docker Desktop manually.

See more in the detailed guides below:

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

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

{% content-ref url="/pages/-MbpJWmV3cwn0JVn5fvs" %}
[Windows requirements](/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](/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](/usage-guide/themes.md)
{% endcontent-ref %}