Mage-OS 2.1 is out now!

We are excited to announce the release of Mage-OS Distribution 2.1.0, continuing our mission to provide a community-driven, open, and reliable e-commerce platform.

This release includes bug fixes, performance improvements, expanded database compatibility, and new developer tools.

Our foundation

Mage-OS 2.1.0 is based on a solid foundation of proven, well-supported software:

Bug fixes

Several issues have been resolved in this release:

• Customer group extension attributes Fixed a plugin that was overwriting existing extension attributes instead of preserving them (#53)
• Customer file attribute handling Prevents session files from being written to the filesystem for non-file customer attributes (#174)
• Full Page Cache after login Resolved an issue where native FPC didn’t work properly for logged in customers (AC-14999) (#176)
• SRI hash failures Fixed Subresource Integrity hash failures that occurred when using JavaScript bundling and minification together (#177)
• Plugin generation area order Fixed setup:di:compile to generate plugins in the correct area order, preventing frontend cache regeneration on first request (#194)
• Mage-OS Page Builder Widgets module updated to 1.3.3
  • Fixed css hiding other modal form labels (#10)
  • Fixed virtualTypes on Block classes used by widgets (#13)

New features

Theme registration status command

A new CLI command helps developers identify themes that exist in the filesystem but are not registered in the database:

bin/magento theme:registration:status

This helps detect when theme changes require setup to be run, for zero-downtime deployment processes. (#186)

Queue configuration status command

A new CLI command detects inconsistencies in message queue configuration for both MySQL and AMQP (RabbitMQ/AmazonMQ) backends:

bin/magento queue:config:status

This helps detect when message queue changes require setup to be run, for zero-downtime deployment processes and health checks. (#188)

Expanded database support

We’ve expanded database compatibility to better match real-world hosting environments:

• MySQL: 5.7, 8.0 through 8.4
• MariaDB: 10.2 through 10.11, and all 11.x versions

This gives you more flexibility in choosing your database server and makes upgrades smoother. (#189)

Thanks to everyone who contributed!

This release was made possible by the contributions of our community members:

• @avstudnitz (Andreas von Studnitz)
• @dadolun95 (Davide Lunardon)
• @furan917 (Francis Gallagher)
• @jakwinkler (Jakub Winkler)
• @melindash (Melinda Humphrey)
• @rhoerr (Ryan Hoerr)
• @rogerdz
• @samdjames (Sam James)

Want to participate?

Mage-OS is a community-driven project, and we welcome contributions of all kinds. Whether you’re fixing bugs, adding features, improving documentation, or helping with testing, your contributions make a difference.

• Mage-OS GitHub
• Mage-OS Discord

Installation

New installations

composer create-project --repository-url=https://repo.mage-os.org/ mage-os/project-community-edition=2.1.0 <install-directory-name>

Upgrading from a previous Mage-OS version

composer require mage-os/product-community-edition=^2.1 --no-update
composer update
bin/magento setup:upgrade

Migrating from Adobe Commerce or Magento Open Source

See our migration guide for detailed instructions on switching to Mage-OS.

We hope you enjoy Mage-OS 2.1.0. As always, please report any issues on GitHub and join the conversation on Discord.