Shopware 5¶

Shopware is a open source e-commerce software written in PHP. The community edition is distributed under the AGPLv3 license.

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/shopware/blob/5.6/license.txt

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]$ wget -O shopware.zip https://www.shopware.com/de/Download/redirect/version/sw5/file/install_5.7.16_f371e60500e0442c85460f707edd6e443918cc26.zip
[isabell@stardust isabell]$ unzip -d html shopware.zip
[isabell@stardust isabell]$ rm shopware.zip
[isabell@stardust isabell]$

Setup¶

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

Configuration¶

Cronjob¶

Add the following cronjob to your crontab:

*/15  *  *  *  * php /var/www/virtual/$USER/html/bin/console sw:cron:run > $HOME/logs/shopware-cron.log 2>&1

Updates¶

Shopware can be updated via AutoUpdate. If an update is available you will be notified in the backend. From there you can start the update.

Note

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

Tested with Shopware 5.7.16, PHP 8.1 and Uberspace 7.13.0

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