Updating your Shopware e-commerce platform is crucial for security, performance, and access to the latest features. Our guide offers a step-by-step walkthrough to confidently navigate the update process and keep your online Store running smoothly. Let’s learn how to update Shopware like a pro!
Create a test Environment.
We strongly advise creating a test environment before updating Shopware to test the update thoroughly in your specific setup. Learn how to set up a test environment with our detailed guide.
Secure Your Update:
Ensure a secure update process by creating a backup, allowing for a seamless rollback in case of issues. Prioritize this step, even if a test environment has been utilized, to safeguard the live system during the update.
Extension Compatibility – IMPORTANT:
Ensure a smooth update by confirming the compatibility of your installed extensions with the latest Shopware version. Check for updates in our Store, use the Auto-Updater in the admin, or verify compatibility in your Shopware Account under Licenses to prevent potential issues during the update process.
Updating shopware via the browser
Use the Shopware Installer for quick and easy Shopware installation or updates. Save the same PHP file in an empty public directory; it initiates the installation process when called. For existing installations, the same file triggers the update process seamlessly.
- Download PHP File:
- Access the download area and download the Shopware Installer PHP file (1).
2. Move to Public Folder:
- Place the downloaded PHP file into the public folder of your existing Shopware installation.
3. Open in Web Browser:
- To initiate the installation or update process, open the PHP file in your web browser
Update per administration
To perform a direct update through the administration, follow these steps:
1. Go to Settings > System > Shopware Update.
2. you can view your current version in the window that appears.
3. Note that the ‘Update code’ field is optional and is typically required for specific bug fixes provided by support.
4. Please remember that administration updates are limited to the latest version available.
Step 1: Look for an update
Click the ‘Check for Updates’ button to easily search for and verify if you can update your Shopware platform to the latest version.
Step 2: Check system requirements
Before starting the update process, the system checks all requirements to ensure they are met. Please verify and adjust system requirements to ensure a smooth update process.
Step 3: Deactivate extensions
Please make sure to deactivate any incompatible extensions before installing the update. Once you have confirmed that you have created a backup, the ‘Install’ button will activate, and you can proceed with the update. If any incompatible or unverifiable extensions are found, a prompt will appear.
What options do I have if the automatic updater cannot deactivate all extensions?
- Deactivate All Extensions:
- If the update doesn’t initiate, choose ‘Deactivate all extensions’ instead of the default option. Retry is starting the update.
2. Manual Deactivation:
- If the automatic updater can’t deactivate extensions, manually deactivate them under ‘Extensions’ > ‘My Extensions’ in the Shopware backend.
3. Database Deactivation:
- Deactivate extensions directly in the database using detailed instructions. Exercise caution and follow the provided guidelines.
4. Major Update Deactivation:
- Deactivate all extensions for major updates (e.g., 6.4 to 6.5). Utilize the instructions from point 3, and omit the WHERE part in the SQL command for deactivation.
5. Skip Extension Deactivation Options:
- If you’ve used points 2 to 4 during the update form, avoid selecting any options for deactivating extensions.
These solutions have effectively resolved update initiation issues, ensuring a smoother Shopware update process.
Step 4: Install the update
If you successfully completed the installation steps, you will see green ticks on the left. That indicates that you can now finish the update.
Update with Composer
It is worth noting that the statement is already valid for Shopware version 6.3.0.
To proceed, please go to your Shopware root directory and execute the given command:
This applies from Shopware 6.3.0 onward. Navigate to your Shopware root directory and run the following command.
bin/console system:update:prepare
To update your Shopware installation, run the following command in your Shopware root directory:
composer update
After executing the necessary updates, run the following command in your Shopware root directory to finalize the process and run migrations:
bin/console system:update:finish
To force-update all configuration files, execute the following command in your Shopware root directory:
composer recipes:update
Avoid known issues
APP_ENV=dev web_profiler Missing Extension Error:
- Install the Profiler bundle for versions before Shopware 6.4.17.0 to resolve the missing extension error. Run the following command:
composer require --dev profiler
Framework:demo-data Missing Faker Classes:
- For versions before Shopware 6.4.17.0, install additional packages to enable the framework:demo-data command. Run the following command:
composer require --dev mbezhanov/faker-provider-collection maltyxx/images-generator
Elightwalk, a growing Shopware development firm, is committed to providing high-quality services. We prioritize client pleasure, provide thorough maintenance and support, and operate projects clearly and openly. We value your time and strive to complete projects on schedule without sacrificing code quality. Our objective is to deliver Shopware development services that are dependable and efficient, exceeding your expectations.