Add latest Shopware 6 install steps

docs/ecommerce-applications/shopware-6/how-to-install-shopware-6-on-hypernode.md

@@ -1,9 +1,9 @@
 ---
 myst:
   html_meta:
-    description: Shopware 6 requires a Hypernode Falcon S hosting plan or larger.
-      We explain how you can setup the latest version of Shopware 5 on Hypernode.
-    title: 'How to install Shopware 6 on Hypernode? '
+    description: Learn how to install the latest version of Shopware 6 on Hypernode
+      with Composer.
+    title: How to install Shopware 6 on Hypernode?
 redirect_from:
   - /en/ecommerce/shopware/how-to-install-shopware-6-on-hypernode/
   - /knowledgebase/how-to-install-shopware-6-on-hypernode/
@@ -13,72 +13,122 @@ redirect_from:
 
 # How to Install Shopware 6 on Hypernode
 
-This article will explain how you can setup the latest version of Shopware 6 on Hypernode as easy as possible.
+This article explains how you can set up the latest version of Shopware 6 on Hypernode as easily as possible.
 
-## Upgrade Your PHP Version
+## Install the Latest Version of Shopware 6
 
-Shopware 6 need at least PHP version 7.4 to be able to run. So the first thing to do is upgrade your PHP version to 7.4 with the following command:
+The latest versions of Shopware 6 are installed with Composer. The steps below are based on Shopware 6.7.
+
+### Check the Requirements
+
+Shopware 6.7 has the following requirements:
+
+| Software | Required version                      | Recommended on Hypernode |
+| -------- | ------------------------------------- | ------------------------ |
+| PHP      | 8.2 or higher                         | 8.4                      |
+| MySQL    | 8.0.22 or higher                      | 8.4                      |
+| Node.js  | 20 or higher                          | 24                       |
+| Composer | 2.2 or higher                         | 2.x                      |
+| Redis    | 7.0 or higher (optional, for caching) | Redis 7                  |
+
+For the full list of requirements, see the [Shopware system requirements](https://developer.shopware.com/docs/guides/hosting/).
+
+### Upgrade Your PHP Version
+
+Change the PHP version to PHP 8.4 with the following command:
 
 ```bash
-hypernode-systemctl settings php_version 7.4
+hypernode-systemctl settings php_version 8.4
+```
+
+### Upgrade Your MySQL Version
+
+Shopware 6.7 needs at least MySQL 8.0. You can check your current MySQL version with `mysql --version`. Upgrade to MySQL 8.4 with the following command:
+
+```bash
+hypernode-systemctl settings mysql_version --value 8.4
+```
+
+```{important}
+You can only upgrade to MySQL 8.4 from MySQL 8.0, and you cannot downgrade your MySQL version afterwards. See [How to Use MySQL on Hypernode](../../hypernode-platform/mysql/how-to-use-mysql-on-hypernode.md) for the full upgrade path.
 ```
 
-## Change the MySQL Version to 5.7
+### Upgrade Your Node.js and Composer Versions
 
-Shopware 6 needs MySQL 5.7 to be able to run. You can change the MySQL version by running the following command:
+Shopware uses Node.js to build the administration and storefront. Change the Node.js version to 24 and make sure you use Composer 2:
 
 ```bash
-hypernode-systemctl settings mysql_version 5.7
+hypernode-systemctl settings nodejs_version 24
+hypernode-systemctl settings composer_version 2.x
 ```
 
-## Install Node.js v10.16
+Use `livelog` to check when the changes are applied.
+
+### Create the Shopware Project
+
+Create a new Shopware project in `/data/web/shopware` with Composer:
 
 ```bash
-hypernode-systemctl settings nodejs_version 10
+cd /data/web
+composer create-project shopware/production shopware
 ```
 
-## Two Ways to Install Shopware 6
+This installs the latest stable version of Shopware 6. If you need a specific version, add it to the package name, for example `shopware/production:6.7.15.1`.
 
-There are two ways to install Shopware 6: either by using the pre-install or doing it manually. See below for the two options. *Please note: you only have to use one of the two options to install Shopware 6.*
+### Configure the Database Connection
 
-### Download and Install Shopware 6 Using the Pre-install
+Shopware reads its configuration from the `.env.local` file in the project folder. Look up the password of the `app` MySQL user:
 
-On Hypernode we offer an easy way to install Shopware 6 using one of our pre-install images. Use the following command to install Shopware 6.
+```bash
+cat ~/.my.cnf
+```
+
+Then create the `.env.local` file:
 
 ```bash
-hypernode-systemctl preinstall shopware_6
+cd /data/web/shopware
+cat > .env.local <<'EOF'
+APP_ENV=prod
+APP_URL=https://APPNAME.hypernode.io
+DATABASE_URL=mysql://app:PASSWORD@mysqlmaster:3306/shopware
+EOF
 ```
 
-### Download and Install the Latest Version of Shopware 6
+Replace `APPNAME` with the name of your Hypernode and `PASSWORD` with the password from `~/.my.cnf`. If the password contains special characters, such as `@`, `/` or `#`, [URL-encode](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding) these characters.
+
+### Install Shopware
 
-Download the latest Shopware 6 version to the public folder from the [Shopware website](https://www.shopware.com/en/download/#shopware-6) by right clicking on "Download for free" click on "Copy Link Address" and paste the link after the `wget` command below.
+Run the Shopware installer. The `--create-database` option creates the `shopware` database for you:
 
 ```bash
-mkdir shopware
-cd shopware
-wget https://releases.shopware.com/sw6/install_6.0.0_ea2_1571125323.zip
+cd /data/web/shopware
+bin/console system:install --basic-setup --create-database
+```
 
-# Unzip the downloaded .zip file
-unzip install_6.0.0_ea2_1571125323.zip
+This creates the database tables, a default sales channel, and an admin user.
 
-# Enable secure document root
-cd ~
+### Enable the Secure Document Root
+
+The web root of Shopware is the `public` folder of the project. Point the Hypernode document root to this folder:
+
+```bash
 rm -rf /data/web/public
 ln -s /data/web/shopware/public/ /data/web/public
 ```
 
-## Install Shopware 6
+Your shop is now available at `https://APPNAME.hypernode.io`.
 
-Now open your browser and browse to `https://APPNAME.hypernode.io/recovery/update/index.php`. At this point you can follow the guide through your browser. Make sure to fill in the right details at the **Configure database**:
+### Log In to the Administration
 
-- Database server: localhost
-- Database user: app
-- Database password: run `cat ~/.my.cnf` in your terminal and copy that password.
-- Database name: Select your database
-- Select "new database", and pick a name you like
-- Fill in the **Basic shop set-up** how you see fit.
+Open `https://APPNAME.hypernode.io/admin` in your browser and log in with the default credentials:
+
+- Username: `admin`
+- Password: `shopware`
+
+```{warning}
+Change the password of the admin user directly after your first login.
+```
 
-**Done!** You’ve now successfully installed Shopware 6.
+**Done!** You've now successfully installed the latest version of Shopware 6.
 
-**Demo data**
-If you’d like you could install demo data as well. To do this you’ll need to login the backend: `http://APPNAME.hypernode.io/admin/` with the credentials you entered during the step: Basic shop set-up at the installation. At your first login you’ll see the “First Run Wizard”, make sure to install the Demo data at the “Demo data” menu.
+For better performance, configure [Redis](./how-to-configure-redis-for-shopware-6.md) and [Varnish](./how-to-configure-varnish-for-shopware-6.md) for your shop.