Shopware 6¶

Shopware is a open source e-commerce software powered by Symfony and Vue.js. The community edition is distributed under the MIT license. It’s the successor of Shopware 5.

Note

For this guide you should be familiar with the basic concepts of

License¶

All relevant legal information can be found here

https://github.com/shopware/platform/blob/master/LICENSE

Prerequisites¶

We’re using PHP in the stable version 8.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.1'
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
--default-character-set=utf8mb4
--user=isabell
--password=MySuperSecretPassword
[isabell@stardust ~]$

Your shop URL needs to be setup:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation¶

Download¶

Check the Shopware website for the latest release and copy the URL to the ZIP file. Replace the URL with the one you just copied.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/
[isabell@stardust isabell]$ curl -o shopware.zip https://releases.shopware.com/sw6/install_v6.4.17.2_4d2c85fb448571fa4f30edce635f33a67dda1d76.zip
[isabell@stardust isabell]$ unzip -d shopware shopware.zip
[isabell@stardust isabell]$ rm shopware.zip
[isabell@stardust isabell]$

Since Shopware uses the sub directory public/ as the DocumentRoot, you need to remove your DocumentRoot and create a symlink to the shopware/public/ directory:

[isabell@stardust isabell]$ rm -f html/nocontent.html; rmdir html
[isabell@stardust isabell]$ ln -s /var/www/virtual/$USER/shopware/public html
[isabell@stardust isabell]$

Setup¶

Point your browser to your domain, e.g. https://isabell.uber.space and follow the instructions to set up Shopware. We suggest you use an additional database. For example: isabell_shopware.

Configuration¶

To configure PHP according to the Shopware system requirements, go to $HOME/etc/php.d/, create shopware.ini and add the following lines:

memory_limit = 512M
apc.enable_cli = 1
opcache.memory_consumption = 256

Note

After setting these PHP parameters, restart PHP to activate the changes

[isabell@stardust ~]$ uberspace tools restart php
Your php configuration has been loaded.
[isabell@stardust ~]$

Updates¶

Note

Check the update feed regularly to stay informed about the newest version.

Tested with Shopware 6.4.17.2, PHP 8.1 and Uberspace 7.13.0

Written by: Yannick Ihmels <yannick@ihmels.org>