You are currently viewing the article on an older Shopware version!

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 Anpassungen


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 /path/to/.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. 

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.
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 configuration

After the Shopware license has been accepted, the credentials for accessing the Shopware database are entered. You can either create an empty database for the  installation in advance or the installer can create one for you.
To create a new database, it is necessary to check the box New Database and enter a name for the database.
If one or more databases already exist, they will be listed in the field Database Name after the user and password have been entered. Select the database that is intended for shopware.
Please note that existing databases must be empty in order to import the tables required for Shopware.
If you display the advanced settings, you can also specify the port of the database and (optionally) a socket.

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 and US Dollar. The currency you choose here will be entered as default in the shop with the currency factor 1. You can also add other 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?