We are excited to announce the release of Mage-OS Distribution 1.2.0, another step in the building of the definitive open source e-commerce platform!

Our foundation

Mage-OS 1.2.0 is built on Magento Open Source 2.4.8-p1, and includes all platform updates and community fixes from the upstream release. See the full Magento Open Source 2.4.8-p1 Release Notes for details.

The latest recommended software versions are:

Composer2.8
Elasticsearch— (no longer supported)
OpenSearch2.19
MariaDB11.4
MySQL8.4
PHP8.4/8.3
RabbitMQ4
RedisValkey 8 (or Redis 7.2+)
Varnish7.6
Apache2.4
nginx1.26

Updates to our backend theme

In this release, we’ve improved the user experience by fixing username clipping, introducing smooth view transitions, preventing layout jumps with a new scrollbar-gutter, adjusting footer copyright spacing, and resolving an issue where media search overlapped the upload image message.

Thanks to everyone that helped with this release!

Mage-OS wouldn’t exist without a great community. ❤️ Among others, thank you to:

  • Artem Kozynets
  • Damien Retzinger
  • Fabrizio Balliano
  • Ryan Hoerr
  • Sean van Zuidam
  • Vinai Kopp

Along with recent Mage-OS Lab contributors:

  • Davide Lunardon
  • Luca Fuser
  • Ryan Sun
  • Samuele Martini
  • Stefano Tusino

And to everyone that has helped with testing, feedback, and our weekly tech meetings!

Want to participate?

Are you interested in contributing to Mage-OS, or have a bug or improvement you’d like to make? We welcome pull requests at https://github.com/mage-os/mageos-magento2!

If you have a bigger project in mind, please join Discord and chat about your idea. We’d be delighted to hear from you, and help figure out how your idea best fits into Mage-OS!

Installing Mage-OS

You can create a new Mage-OS project with the following SSH command:

composer create-project --repository-url=https://repo.mage-os.org/ mage-os/project-community-edition .

After a successful composer download, you will need to run the installer. Please see DevDocs: Installation Guide for Mage-OS

Moving to Mage-OS

If you are already using Magento 2.4 and PHP 8.2+, you can change to Mage-OS by running the following in SSH:

composer config repositories.0 composer https://repo.mage-os.org/ && 
    composer require mage-os/product-community-edition --no-update && 
    composer remove magento/product-community-edition magento/composer-dependency-version-audit-plugin magento/composer-root-update-plugin --no-update && 
    composer remove sebastian/comparator --dev --no-update && 
    composer update --no-plugins --with-all-dependencies

We strongly recommend updating to the latest Magento version (currently 2.4.8) before changing to Mage-OS, to minimize issues.

Your specific situation may require additional changes to your composer.json file. Generally this will involve changing magento/ package names to mage-os/, or updating dependency versions.