Install Shopware 6

Prior to installation

Before you install Shopware, you should pay attention to some requirements. Below we explain to you which ones they are.
 

Htaccess adjustments


Note that a .htaccess protection may result in the admin not being able to open it.
A short term solution is to not authenticate requests to the URL "/api" in the .htaccess:

AuthType Basic
AuthName "Please login."
AuthUserFile /pfad/zur/.htpasswd

<RequireAny>
    Require expr %{THE_REQUEST} =~ m#.*?\s+\/api.*?#
    Require valid-user
</RequireAny>

 

System requirements

Prior to installing, you should make sure that your system meets the system requirements for Shopware 6.

Routing settings

In addition, it is recommended to adjust the routing settings of your web server if necessary. 
A corresponding example based on Apache is shown below. 


<VirtualHost *:80> 
 ServerName "_HOST_NAME_" 
 DocumentRoot _SHOPWARE_DIR_/public 

 <Directory _SHOPWARE_DIR_> 
  Options Indexes FollowSymLinks MultiViews 
  AllowOverride All 
  Order allow,deny 
  allow from all 
 </Directory> 

 ErrorLog ${APACHE_LOG_DIR}/shopware-platform.error.log 
 CustomLog ${APACHE_LOG_DIR}/shopware-platform.access.log combined 
 LogLevel debug 
</VirtualHost>
 

Please remember to replace _SHOPWARE_DIR and _HOST_NAME_ with your settings.
You will also notice that the Document root directory points to the /public folder in the Shopware 6 installation directory.
This is necessary because the frontend and the admin interface are located behind it, so it is not necessary to refer to the public directory in the URL in the browser to call the frontend or the admin interface. 

Contact your hosting partner if you have any questions about routing.

Downloading Shopware

After you have ensured that the system requirements for Shopware 6 are met and the routing settings of your web server are correctly configured, you can download the Shopware 6 installer and unpack it in the desired directory on your system. Also make sure that the unpacked files and directories have write permissions.

Checksum

What are checksums and what are they used for?
With the help of programs or program extensions, checksums can be determined from a downloaded file using the set algorithm (e.g. MD5, SHA, etc.). The checksum from the downloaded file can be compared against the checksum that's specified on the download page.

Where can I find the Shopware checksums?
You can find the Shopware checksums with the algorithm SHA256 on the Shopware download page. If you display the different versions of Shopware there, a checksum will be displayed on the right-hand side next to the Installation and Update buttons when you move the mouse over them.


How do I compare checksums?
To compare the checksum, you can use a program that displays the checksum after adding the downloaded file to the program using the selected algorithm. 
For example, you can use the program FileVerifier++, which is also explained as a check program at the Federal Office for Information Security. 
For a more detailed explanation, please click here: Federal Office for Information Security (in German).

What to do if the checksums are different?
If the checksums are different, the data was transferred incorrectly or the checksum is no longer correct because the data was legitimately updated or the data was not legitimately changed during the transfer.
It is best not to open the downloaded file and delete it directly. If you download the file again and the checksum differs again, you should inform us about this, as there may be an error.

Running the Installer

Please ensure that the system requirements for Shopware 6 are met and that the routing settings of your web server are configured correctly. Then you can proceed to download the Shopware 6 installer. All you need to do is extract it into the desired directory on your system. Make sure that the unzipped files and directories have write access.
To run the installer, simply visit the URL of your shop and you will be greeted by the Shopware 6 installer, which will guide you through the installation step by step.

Under certain circumstances it may be necessary with some hosters to write /index.php after the URL.

Here you can change the language of the installer. The language can also be changed at any time using the country abbreviations at the bottom right-hand corner of the screen.
By clicking on Next you can continue the installation.

 

Checking the system requirements

In the second step of the installation, the system requirements are checked to see if they are met. The arrowbuttons list the requirements, the folded out menu show which requirements are not met or which settings can be optimized.

General terms and conditions

In the next step you can read the license under which Shopware is licensed. In order to continue the installer, you must agree to the license terms.

 

Database import

In this step the Shopware database is imported. Click on Start installation to initiate the database import.

Configuration

In the last step you specify the basic settings for your shop:

  • The shop email address will later be the global email address from which all emails are sent.
  • The default system language specifies which language this installation will use as default. This affects both the frontend and the administration area.
  • You have the following default currencies to choose from: Euro, British Pound, US Dollar, Polish zloty, Swiss francs, Swedish kronor, Danish kronor, Norwegian kronor and czech kronor. The currency you choose here will be entered as default in the shop with the currency factor 1. You can add more currencies directly or add more currencies with corresponding conversion factors afterwards.
  • The area starting from the admin email address field defines the administrator user for the administration interface of Shopware 6. Enter his or her relevant data here. If necessary, you can create and manage additional users in the admin interface after installation.

Please bear in mind that the default language and the default currency cannot be changed at a later date.

   

Done

The installation is now complete and the installer will automatically redirect you to the admin interface. To login use the admin user you have just created to set up your Shopware 6 shop.

Was this article helpful?