Shopware 6.5 Installation

This article describes how Shopware 6.5 can be installed and configured on the Managed Shopware Server.



Prerequisites

  • Active Managed Shopware Server
  • Plesk Control Panel access



Create website

A new website within Plesk is required for the installation of Shopware.

You can create a new website using the Add domain button. To do this, enter the desired domain under which the Shopware store should later be accessible.

Plesk - Add new domain


If you do not yet have your own domain, you can use the working domain of the Shopware server. This corresponds to the syntax: sXXXX.creoline.cloud. Replace the prefix with your server ID.


Plesk - Add new domain & system user


Also specify the system user name that will later become the owner of the Shopware installation on the server.



Create database

A MySQL database must be created for the successful installation of Shopware. You can create a new database via the menu items Databases โ†’ Add database.




Enter the desired database name, the database user name and the password for the new database user and confirm your entries by clicking on OK.


Add MySQL database



Download installation package

Download the latest installer for Shopware 6.5 via the following link:

https://github.com/shopware/web-recovery/releases/latest/download/shopware-installer.phar.php

More information can be found at https://www.shopware.com/de/download/


In Plesk, navigate to Files โ†’ httpdocs and upload the file named shopware-installer.phar.php that you just downloaded from the Shopware download page.

Plesk - Upload Shopware Installer



Perform installation via web browser

The installation of Shopware 6.5 can now be carried out using a web browser. To do this, navigate to the domain that you used to create the website in the first step.

Example:

https://www.meinedomain.de/shopware-installer.phar.php

Change www.meinedomain.de to your previously created domain in Plesk.

In the first step, you can specify the language of the installer and confirm this with "Next".

Shopware 6.5 Installer

On the following page you can customize the PHP execution file if it is not automatically suggested by the installer. This is normally located under:

/opt/plesk/php/8.2/bin/php

Confirm the configuration with "Save configuration".


Next, we select the Shopware version to be installed. This is normally predefined. In our case, the latest version is 6.5.0.0. Click on "Download" to upload the important Shopware files to our server. The document master directory is changed in the next step.


Shopware 6.5 expects a different document root directory compared to Shopware 5. The document root can be customized in Plesk via the Hosting and DNS -> Hosting Settings tab.


Also enter the subdirectory /public here so that the document root contains the main directory and the public directory.


To additionally secure your website via SSL/TLS, you can set up a free Let's Encrypt certificate. You can find step-by-step instructions in the Help Center article Setting up a Let's Encrypt certificate.


Once we have changed the domain directory to /public, we can continue with the installation of Shopware.

You can change the language of the installer again and confirm the selection by clicking on "Next".


In the next step, the Shopware Installer checks whether the system requirements for the installation of Shopware 6.5 are met. If these are marked with a green tick, you can continue the installation with "Next".


Agree to the Shopware terms and conditions and continue with the installation. The next step would be to enter the data from the previously created database into the Shopware installation.


Once the database has been successfully imported, you can configure the store master data and the first Shopware administrator.



Call up Shopware 6 Administration

Shopware 6 Administration can be accessed via the /admin directory. Navigate to your store domain and add the directory /admin. You can then log in to Shopware Administration with the previously configured login information.



Problem solutions

If the frontend at sXXXXX.mydomain.com is not displayed correctly, log in to the backend under /admin and navigate to your Shop โ†’ Themes and activate the "Shopware default theme" again. Your store should then be displayed normally again.