Install Shopware 6
These instructions will explain what you need to consider before installing Shopware 6 and guide you through the installation process.
Prior to installation
Before you install Shopware, you should pay attention to some requirements. Below we explain to you which ones they are.
You can generally run Shopware on a self-hosted server, but for optimal performance we recommend installing Shopware on a server of one of our hosting partners.
Htaccess adjustments
The htaccess file is a configuration file on your web server. Among other things, it specifies which users have access to the shared files and folders. With a htaccess file you have the possibility to allow access to your store only for selected users.
During the installation you should do without the htaccess protection or use the following solution.
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.
If you are unsure about any of the requirements, we recommend that you consult with the server hoster to ensure these requirements are met.
Routing settings
In addition, it is recommended to adjust the routing settings of your web server if necessary.
A corresponding example in the form of a vHost for Apache2 is listed below.
<VirtualHost *:80>
ServerName "_HOST_NAME_"
DocumentRoot _SHOPWARE_DIR_
<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 keep in mind to replace _SHOPWARE_DIR_ and _HOST_NAME_ with your settings.
You may also notice that the DocumentRoot in the above example does not point to the /public folder in the Shopware 6 installation directory. Behind the public folder is the storefront and the admin interface, but these are only available after installation. So after the installation you have to route to DocumentRoot _SHOPWARE_DIR_/public. This is necessary so that your customers do not have to call the store via https://shopware-shop.de/public for example.
Shopware 6 will point this out to you after the installation.
Contact your hosting partner if you have any questions about routing.
Shopware Installer
With the Shopware Installer you can install and update Shopware in a few steps. The same PHP file is used for both. This way an automated installation or update is performed.
If the file is saved in an empty public directory and called, the installation process is started.
For an already existing Shopware installation, the update process is started.
Download Shopware
After you have made sure that the system requirements for Shopware 6 are met and the routing settings of your web server are configured correctly, you can download Shopware 6. Also make sure that the unzipped files and directories have write permissions.
Step 1: Download the PHP file from the download area.
Step 2: Afterwards you create a folder on your webserver for your Shopware installation and move the PHP file into this folder.
Step 3: Then open the file in your web browser:
www.my-url.com/ShopwareFolder/shopware-installer.phar.phpThe installation will now start.
You will then be guided through the installation wizard, where you can enter some information.
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
In this step it is time to configure the database.
Under point (1) you define the server. In most cases the database is located on the same server, so you enter localhost or 127.0.0.1 here. Sometimes there are problems with the translation with the Unix socket, so you might prefer to enter an IP address, because it uses a TCP connection.
Under point (2) the user name of the database is entered.
Under point (3) the password of the database is entered.
Under point (4) the port of the database is entered.
Under point (5) the file path of the SSL certification authority (CA) is entered. It is important to enter an SSL certificate if an external database server is defined and this requires a secure connection.
Under point (6) the file path of the SSL certificate is entered.
Under point (7) the file path of the SSL certificate key is entered.
Under point (8) it can be defined whether a check of the certificate should take place. This is important in cases where, for example, self-signed SSL certificates are used that do not have an authorized certification authority.
Under point (9) the name of the database is entered.
Under point (10) you can create a database.
Database import
In this step the Shopware database is imported. Click on Start installation to initiate the database import.
The installation wizard will inform you that the installation is completed. Click next to proceed to the configuration.
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.
Installation via Composer
As an alternative to the installation with the installer, Shopware 6 can also be installed via Composer. You can find information about this in our developer documentation.