You are currently viewing the article on an older Shopware version!
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>
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.
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.
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.
In this step you can read the license under which Shopware is licensed. To proceed, you have to agree to this license terms.
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.
In this step the Shopware database is imported. Click on Start Installation to initialize the database import.
In the last step you define the basic settings of your shop:
Note that the main language and the default currency cannot be changed at a later date.
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.