# Existing Magento 2 setup

You might want to install ScandiPWA as a Magento theme (without using [Create Magento App](http://docs.create-magento-app.com/)) – and this is supported out of the box! You can install the theme as a local composer module, continuously build it, and Magento will be able to recognize it as a valid Magento theme. Then, you will be able to select your ScandiPWA-based theme in the Magento configuration.

{% hint style="info" %}
If you are using[ Create Magento App ](https://scandipwa.gitbook.io/create-magento-app/)you're lucky! It has a built-in ScandiPWA linking function built-in. Read how to [setup ScandPWA with CMA](/getting-started-1/magento-theme-mode.md) in minutes!
{% endhint %}

## Prerequisites

Make sure that you have a [supported Magento version](https://manual.scandipwa.com/pwa/magento-version-mapping)! Also, make sure your server is configured to point into `<MAGENTO ROOT>/pub` directory.

#### Node v14+

```bash
node -v # should be 14^
```

You can instal Node using [`nvm`](https://github.com/nvm-sh/nvm) (recommended) or the [official guide](https://nodejs.org/en/download/package-manager/).

#### Varnish v5+

```bash
varnishd -V # should be 5^
```

In Magento admin go to *Stores > Configuration > Advanced > System > Full Page Cache*. Make sure the `Varnish Cache` is selected in the dropdown, varnish configuration has proper values set in it.

If it is not, please follow [official documentation](https://devdocs.magento.com/guides/v2.3/config-guide/varnish/config-varnish.html) to set it up.

#### Redis v2.5+

```bash
redis-cli -v # should output 2.5^
```

If it is not installed, please follow [this guide](https://codewithhugo.com/install-just-redis-cli-on-ubuntu-debian-jessie/) to obtain it.

## Install the ScandiPWA theme with Composer

We recommend you keep your theme source in a `src/localmodules` directory. You will then be able to configure composer to install the theme from here as a local module.

```bash
mkdir src/localmodules
cd src/localmodules
```

{% tabs %}
{% tab title="If you're just getting started" %}
Verify that your system has the [required tools](/getting-started-1.md#prerequisites) installed, and [create a new theme](/getting-started-1.md#installation)!
{% endtab %}

{% tab title="If you already have a theme" %}
Simply move your ScandiPWA theme into the `localmodules` directory:

```bash
mv ~/Projects/<your-theme> . # path to your theme
cd <your-theme>
```

{% endtab %}
{% endtabs %}

Build or start the application in Magento mode:

{% tabs %}
{% tab title="yarn (recommended)" %}

```bash
BUILD_MODE=magento yarn start # or build
```

{% endtab %}

{% tab title="npm" %}

```bash
BUILD_MODE=magento npm start # or build
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
I**f you chose `start` – you will need to keep this process running**. It continuously re-builds the theme when changes are made. Open a new terminal tab to enter new commands.
{% endhint %}

Now the new theme is created, but we need to install it using Composer. We will install the newly-created theme by taking advantage of Composer's ability to install from [local repository sources](https://getcomposer.org/doc/05-repositories.md#path).

First, we add our theme as a local repository source. This will alter `composer.json` to add a new item in the `repositories` field:

```bash
composer config repo.theme path localmodules/<your-app-name>
```

Next, we install our theme by using `require`. This will resolve the package to the localmodules directory we configured above:

```bash
composer require scandipwa/<your-app-name>
```

## Configure persisted-query

For improved ScandiPWA query caching to work, you must configure `scandipwa/persisted-query`. For convenience, there are additional flags available for `php bin/magento setup:config:set` command:

| Flag            | Required? | Description                                                              | Example     |
| --------------- | --------- | ------------------------------------------------------------------------ | ----------- |
| `--pq-host`     | Yes       | Persisted query Redis host                                               | `127.0.0.1` |
| `--pq-port`     | Yes       | Persisted query Redis port                                               | `6379`      |
| `--pq-database` | Yes       | Persisted query Redis database                                           | `5`         |
| `--pq-scheme`   | Yes       | Persisted query Redis database                                           | `tcp`       |
| `--pq-password` | No        | <p>Persisted query Redis password<br>(empty password is not allowed)</p> | *empty*     |

## Enable the ScandiPWA Theme

Run the `upgrade` command and disable full-page caching:

```bash
bin/magento setup:upgrade
bin/magento cache:disable full_page
```

It is now time to enable the new theme. In the Magento admin panel, navigate to **Content** > **Design** > **Configuration**. Edit the scope you want to change (typically the most general one in the list), and select the new theme. Finally, flush the cache:

```bash
bin/magento cache:flush
```

{% hint style="success" %}
The new theme should now be served on the frontend. Congratulations, you now have a ScandiPWA Magento Theme!
{% 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://docs.scandipwa.com/getting-started-1/magento-integration.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.