# Installing

**Plugin Installation**

For the easiest and safest installation, we highly recommend installing the plugin directly from the official **Shopware Store**. This ensures you always receive stable, tested versions and benefit from simple, one-click updates.

**Advanced Installation (from GitHub)**

For developers or advanced users, you can also install the plugin directly from our GitHub repository: `https://github.com/Nosto/nosto-shopware6`

If you choose this method, you have two options:

**1. From Releases (Preferred GitHub Method)**

We suggest downloading a stable, tagged version from our Releases page: `https://github.com/Nosto/nosto-shopware6/releases`

Please be sure to download the plugin version that matches your Shopware version:

* Plugin Version 6.x.x is for Shopware 6.7
* Plugin Version 5.x.x is for Shopware 6.6
* Plugin Version 3.x.x is for Shopware 6.5

**2. From Branches**

You can also install directly from a branch. You must use the correct branch for your Shopware environment:

* `develop` branch is for Shopware 6.7
* `v5` branch is for Shopware 6.6
* `v3` branch is for Shopware 6.5

***

**Note:** The plugin has the embedded dependency of [Nosto Job Scheduler](https://github.com/Nosto/shopware6-job-scheduler). It's delivered with the plugin sources.

***

**Configuration for Subdirectory Installations and using Nosto Monitoring**

If your Shopware project is located inside a subdirectory (e.g., `/shop/`), you must ensure that the following redirect rules are configured on your web server. This is necessary to properly handle requests to `/nosto-monitoring`.

*(**Note:** "shop" in the examples below should be replaced with the name of your specific subdirectory.)*

**For Apache:**

Add the following lines to your `.htaccess` file, located in the project root (the parent directory of `shop`). These rules should be placed inside the `<IfModule mod_rewrite.c>` block:

```
RewriteRule ^nosto-monitoring/?$ /shop/nosto-monitoring/ [R=308,L]
RewriteRule ^nosto-monitoring/(.*)$ /shop/nosto-monitoring/$1 [R=308,L]
```

Please make sure that:

* Other existing rules do not prevent these new rules from being applied.
* The Apache module `mod_rewrite` is enabled.
* `AllowOverride All` is set in the corresponding `<Directory>` block in your Apache configuration. Otherwise, `.htaccess` rules will not take effect.

**For Nginx:**

Add the equivalent rules to your server configuration (e.g., `/etc/nginx/sites-available/your-site.conf`) inside the main `server {}` block:

```
location ~ ^/nosto-monitoring/?$ {
    return 308 /shop/nosto-monitoring/;
}
location ~ ^/nosto-monitoring/(.*)$ {
    return 308 /shop/nosto-monitoring/$1;
}
```

These redirects ensure that any request to `/nosto-monitoring` is properly redirected to `/shop/nosto-monitoring/`. Please be aware that you may need other rewrite rules to handle your store's general operation from a subdirectory.


---

# 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.nosto.com/shopware-6/getting-started/installing.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.