Updating Shopware

Valid from version:
5.2.21

Creating a backup

Before updating Shopware, create a backup. Only with backups you can rollback easily if needed.

Plugin compatibility - IMPORTANT

Before updating, take care that all of your installed plugins are up-to-date and compatible with the new Shopware version, otherwise your shop may have problems at updating and you have to recover it from your backup. Whether or not your plugins are compatible can be checked in our Community Store, in the Auto-Updater in the backend or in your Shopware Account at Licenses.

Update by Browser

Step 1: Unzip and upload

Unzip the update archive and copy all files by FTP to your Shopware directory on your server - overwrite all existing Shopware files.

Alternatively you can upload and unzip the zip file through your hoster's control panel. This is usually much faster.

Step 2: Maintenance page

After you successfully uploaded the files a maintenance page will be displayed automatically :

Now open the updater: http(s)://www.your-shop.com/recovery/update

Step 3: Execute the update in browser

Follow the update instructions. If you update a shop with a large amount of data, the database migration step may take a while to process.

Step 4: Completing update

To complete the update you must delete the dircetory /update-assets from your Shopware dircetory after the update

Step 5: Delete browser cache

Before you open the Backend, please delete your browser cache (cache & offline website data).

Step 6: Delete shop cache

Open the Backend and delete the following caches in the "Configuration -> Caches/Performance -> Cache" module:

  • Shopware configuration
  • Template cache
  • Compile themes
  • Http proxy cache
  • Proxies and metadata

Open your frontend and check the functionality - if problems occur, additionally delete the following directories:

  • /var/cache/production_xxxxxxxxx

xxxxxxxxx stands for the revision of your Shopware version.

Step 7: Check for plugin updates

After updating Shopware, please open the Plugin Manager and take a look for plugin updates. If available, please process all the available plugin updates to compelete your update.

Update via shell

Caution! This tutorial is made for professionals who are familiar with the shell! The shell executes commands without further inquiry, you should follow this tutorial only if you know what you're doing! Shopware doesn't give any warranty to this, so please make a backup of your server before start working in any case!

Step 1: Unzip and upload

Unzip the archive and copy all your files via FTP to your servers Shopware directory - existing data must be overwritten!

Alternatively you can upload and unzip the zip file through your hoster's control panel. This is usually much faster.

Step 2: Update

Possibility 1: Update via wizard

The wizard update is started with the following command:

 
php recovery/update/index.php
 

The updater will start:

Press ENTER to start the update.

After the database updates, old files and the cache are cleared.

After the update is done, the directory /update-assets has to be removed to set the shop live again:

You can delete the directory /update-assets with the following command:

 
// delete update-assets
rm -r update-assets/
 

Possibility 2: One line update

The update can also be executed without the wizard, you can use the following parameters for this purpose:

  • --quiet => execution in the background
  • --no-interaction => no interaction

The update command would look like this:

 
php recovery/update/index.php --no-interaction --quiet && rm -r update-assets/
 

Step 3: Delete browser cache

Before you open the Backend, please delete your browser cache (cache & offline website data).

Step 4: Validate

Open the frontend and check the shop for functionality - if problems occur, clear the following caches in the cache module in "Configuration -> Caches/performance -> Cache" at first:

  • Shopware configuration
  • Template cache
  • Compile themes
  • Http proxy cache
  • Proxies and metadata

and if needed the following directories:

  • /var/cache/production_xxxxxxxxxxxx

xxxxxxxxxxxx is the revision of your Shopware version.

Step 5: Check for plugin updates

After updating Shopware, please open the Plugin Manager and take a look for plugin updates. If available, please process all the available plugin updates to complete your update.

Update via AutoUpdate

Shopware can also be updated via AutoUpdate, this method is the easiest.

Step 1: Choose the update channel

In the basic settings in "System > Shopware Auto Update" you can choose the update channel on which you want to be notified. Here you can choose the following channels:

  • stable - Stable release version
  • beta - Beta versions - NOT for productive systems!
  • rc - RC versions - NOT for productive systems!
  • dev - Developer versions - NOT for productive systems!

If you have a update code, you can enter this code in the destined field.

Step 2: Update notification

If an update is available for your channel, you will be notified by a growl message:

Clicking on "Close" the notification will be hidden for this version, by clicking "details" the detail window for the update will pop up.

Step 3: Plugins and Requirements

If you keep the update detail window opened, the updater will check your plugins and system requirements for compatibility. If all requirements are fulfilled, it will mark the tabs "Requirements" and "Plugins" with a green check:

If any plugin or requirement is not compatible, a yellow "!" icon is shown in the corresponding tab:

Take a look at the problem and solve it before updating your shop!

In the plugin overview you'll see whether or not the plugins are compatible or if an update is avaiable for a plugin. Please make sure before updating, that all plugins are installed in the newest version, otherwise the update may lead to problems.

Step 4: Backup

You can only update your shop, if you confirm, that you made a backup. Thats is conductive for solving update problems easily and recover your backup in case of trouble at updating.

Step 5: Update

When all requirements are solved you can start the update by clicking "start update". The update process runs automatically until the "cleanup" step.

Here you can see all files which were removed by the updater, you just have to aggree to that.

The updater now finishes the update and also removes the "/update-assets" folder itself. After finishing the update, you can switch back to the frontend or backend.

Now the Shopware updates has finished.

Step 6: Check for plugin updates

After updating Shopware you first have to check you shopware account and set the right shopware version. Afterwards open the Plugin Manager and take a look for plugin updates. If available, please process all the available plugin updates to compelete your update.

Update-FAQ

If problems occur after the update the Update-FAQs may help you.

Using your own maintenance page

Alternatively to the default maintenance page you can use your own by creating a maintenance.html in the Showpare main directory. Shopware will automatically use this page instead of the default one.

Suggested Items

First Run Wizard

Introduction The First Run Wizard guides you through the initial setup of your new Shopware installation. This tool helps you lay the foundation of your shop and connect your domain with your Shopware ID. The First Run Wizard will only open...

read more

Update Guide Shopware 5.2 to Shopware 5.3

Before updating Same procedure as every update: update your installed plugins and make a backup of your environment! Make yourself familiar with the most important changes and the area of "What will break", so you can delete deprecated stuff...

read more

System Requirements

'''Recommendation:''' You can find an overview of Shopware Hosting Partners '''here.''' If you are not sure, which hosting to get, take a look in the article '''"Which hosting should I use?"''' Server The required server...

read more
$ 1,36

Prices incl. legal
VAT + Shipping rates & policies*