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

Install Shopware 6

Htaccess Adjustments

Please note that a .htaccess protection, might cause a lockout of the Admin area.
A Short term solution, make sure that the requests to the URL "/api" not subject to authentication in the .htaccess :

AuthType Basic
AuthName "Please login."
AuthUserFile /path/to/shopware/installation/public/.htpasswd

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

Before you start

But before you start the installation you should make sure that your system meets the system requirements for Shopware 6.
We also recommend that you adjust the routing settings of your web server if necessary. 
We have listed an example of this below using Apache.


<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 DocumentRoot directory points to the /public folder in the Shopware 6 installation directory.
This is necessary because the frontend and the admin interface will be behind it and it is not necessary to refer to the public directory in the URL in the browser to call the frontend or the admin interface. 

Run the installer

After you have made sure 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 extract it to the desired directory on your system. Also make sure that the extracted files and directories have write permissions.
To run the installer, all you need to do is open the URL of your shop and you will be greeted by the Shopware 6 installer start page, which will guide you step by step through the installation from now on.
The first step is to select the language of the installer. The language can also be changed at any time by clicking the country codes at the bottom right of the screen.
Click Next to continue the installation.

Checking the system requirements

The second step of the installation checks whether the system requirements are met. The show all buttons list the requirements and show which requirements are not met or which settings can be optimized.

Terms of service

In this step you can read the license under which Shopware is licensed. To proceed, you have to agree to this license terms.

Database configuration

After the Shopware license has been accepted, the access data to the database is stored in Shopware. An empty database for the Shopware installation can be created in advance or a new database can be created by the installer.
In order to create a new database, it is necessary to check the box New database and assign a name to the database.
If one or more databases already exist, they will be listed in the Database Name field after the user and password have been entered. Select the database intended for Shopware here.
Please note that existing databases must be empty in order to import the tables required for Shopware.
If you click on Show advanced settings, you can also specify the port of the database and (optionally) a socket.

Installation

In this step the Shopware database is imported. Click on Start Installation to initialize the database import.

Configuration

In the last step you define the basic settings of your shop:

  • The E-Mail address of the shop will later be the global e-mail address from which all e-mails are sent.
  • Main language defines which language this installation should use as default. This affects both the frontend and the administration.
  • For the default currency you can choose between Euro, British Pound and US Dollar. The currency selected here is entered as default in the shop with the currency factor 1. You can also add other currencies with corresponding conversion factors afterwards.
  • The area from the field Admin e-mail defines the administrator user for the administration interface of Shopware 6. Enter his data here. If required, you can create and manage additional users in the admin interface after the installation.

Note that the main 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 and log you in with the admin user you just created to set up your Shopware 6 shops.

Was this article helpful?