All notable changes of releases are documented in this file using the Keep a CHANGELOG principles.
This changelog primarily focuses on changes to the dockware/shopware-essentials image. Because this is the foundation of the Shopware environment, we will always release a new essentials version if something changes in the operating system or packages. New Shopware versions, built with this version, will then automatically contain these changes.
- Add PHP 8.5
- Fixed container startup crash when Apache could not restart due to a stale PID file or lingering
apache2workers from an earlier start attempt.
- Skip the PHP-FPM stop/start dance in
make switch-phpwhen the requested PHP version is already the active one. Significantly speeds up container startup for images that don't actually change the PHP version.
- Added a built-in healthcheck. You can now use "docker compose up --wait" to wait until the container is fully ready. (@thx for that brilliant idea @BlackScorp)
- Mailcatcher was not correctly configured to be used in SSMTP configurations.
- Fixed an issue where Shopware was always installed using PHP 8.3, causing crashes when running images with a different PHP versions (e.g. 8.2) and PHP boot scripts or ENV variables (SW_API_ACCESS_KEY, ...). Shopware is now installed using its minimum required PHP version, ensuring compatibility across all configured PHP versions.
- Remove "Xdebug Beta" for PHP 8.4 and switch to official release
- It was possible to start the image with an unsupported Node version which led to problems. The container will now crash during startup to give you immediate feedback.
- Add conditional NVM decompression to prevent restart failures (thx @susannekoerber)
- Add "patch" package to support Composer Patching vendors.
- Replace recursive chown with selective find commands for Git-safe permissions (thx @susannekoerber)
- Preserves Git repository permissions when mounting directories with .git folders (thx @susannekoerber)
- Fixes container restart loop when NVM archive is missing after first run (thx @susannekoerber)
- Initial release (Ubuntu 24.04, PHP 8.2/8.3/8.4, Node 22/24)