Updating Shopware
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.
Only use the "Update Package" from the Changelog Site!
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 directory/update-assets from your Shopware directory 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 by shell
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: Upload and unzip
Please find the correct Shopware version in the change log and and copy the download link for it. Make sure that the link points to the archive with the update.
Now navigate with the shell to the main directory of the shop. There you enter this command to download the update package:
wget URL_FOR_DOWNLOADOften the download link can be added in the shell by right-clicking with the mouse. If your shell does not support pasting from the clipboard, enter the download link manually.
After the download is completed, unpack the archive with:
unzip NAME_OF_THE_ZIP_FILEUsually it is sufficient to enter a unique part of the name after unzip here. The tab key is used to add the complete name.
Important! Both commands must be executed within the Shopware main directory.
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.