Mage-OS Releases

Mage-OS 2.2.2 – Bug Fixes & Compatibility Improvements

mage-os-team — Wed, 15 Apr 2026 18:00:00 GMT

Mage-OS Distribution 2.2.2 is now available. This release brings bug fixes and compatibility improvements across several Mage-OS modules. We recommend updating at your convenience.

Note that it is no longer possible to install the previous version due to a security advisory on webonyx/graphql-php. This update allows the latest versions of that package to fix it.

What’s changed

GraphQL dependency constraint refined Updated webonyx/graphql-php constraint from <15.31.0 to !=15.31.0 !=15.31.1, allowing future 15.31.2+ releases while continuing to block the two known-broken versions. (#218) by @rhoerr
Automatic Translation module updated to 2.1.0
- PHP 8.2 compatibility: removed typed constants that caused errors on PHP 8.2+ (#56) by @SamueleMartini
- Fixed CMS page plain text fields not being translated (#54) by @SamueleMartini
- Fixed CMS block ID and type errors (#60) by @rikwillems
Inventory Reservations Grid: admin OutOfRangeException fixed Added Magento_InventoryAdminUi to the module sequence to resolve an OutOfRangeException in the admin panel. (#16) by @proxiblue

Our foundation

Mage-OS 2.2.2 is built on Magento Open Source 2.4.8-p4, the same upstream base as 2.2.0 and 2.2.1. For details on upstream changes, see the Magento Open Source 2.4.8 release notes and 2.4.8 security patch notes.

Thanks to everyone who contributed!

This release was made possible by:

@rikwillems (Rik Willems) — type error and CMS block fixes in Automatic Translation
@SamueleMartini (Samuele Martini) — PHP 8.2 compatibility and CMS translation fixes
@dadolun95 (Luca Visciola) — PR reviews for Automatic Translation
@proxiblue (Lucas van Staden) — Inventory Reservations Grid fix
@rhoerr (Ryan Hoerr) — GraphQL constraint update and Page Builder cleanup

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.

Installation

New installations

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

Upgrading from Mage-OS 2.2.x

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

Upgrading from an older Mage-OS version

composer require mage-os/product-community-edition=^2.2 --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.2.2. As always, please report any issues on GitHub and join the conversation on Discord.

Mage-OS 2.2.1 – Security & Stability Patch

mage-os-team — Wed, 18 Mar 2026 18:00:00 GMT

Update: Mage-OS 2.2.2 is now available with bug fixes and compatibility improvements. Read the 2.2.2 release post.

Mage-OS Distribution 2.2.1 is now available. This is a security and stability patch for the 2.2 release line — we strongly recommend updating as soon as possible.

What’s fixed

“PolyShell” upload vulnerability blocked (security) Cherry-picked upstream Magento patch (ACP2E-4138) that prevents an attacker from sending an RCE payload via REST API POST requests. This addresses the “PolyShell” vulnerability that can affect insecure server environments. (#210) by @marcelmtz
GraphQL API compatibility restored Pinned webonyx/graphql-php to <15.31.0 to work around a breaking change in that library that broke Magento’s GraphQL API. (#211) by @rhoerr
Checkout reCAPTCHA regression reverted Reverted the reCAPTCHA deferred-loading optimization introduced in 2.2.0, which caused reCAPTCHA failures on checkout pages using hosted/iframe payment forms (e.g. Braintree) and some other integrations. (mageos-security-package#8) by @rhoerr

Our foundation

Mage-OS 2.2.1 is built on Magento Open Source 2.4.8-p4, the same upstream base as 2.2.0. For details on upstream changes, see the Magento Open Source 2.4.8 release notes and 2.4.8 security patch notes.

Thanks to everyone who contributed!

Thank you to @rhoerr (Ryan Hoerr) and @marcelmtz (Marcel Martinez) for handling this release!

Thanks also to @ProxiBlue (Lucas van Staden), @damienwebdev (Damien Retzinger), and @Vinai (Vinai Kopp) for assistance with discovery and testing of the issues and solutions.

Want to participate?

Installation

New installations

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

Upgrading from Mage-OS 2.2.0

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

Upgrading from an older Mage-OS version

composer require mage-os/product-community-edition=^2.2 --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.2.1. As always, please report any issues on GitHub and join the conversation on Discord.

Mage-OS 2.2 is out now!

mage-os-team — Tue, 10 Mar 2026 18:00:00 GMT

Update: Mage-OS 2.2.1 is now available with important security and stability fixes. Read the 2.2.1 release post.

We are excited to announce the release of Mage-OS Distribution 2.2.0, incorporating important security patches from upstream, along with bug fixes and UI improvements. We strongly recommend updating as soon as possible.

Our foundation

Mage-OS 2.2.0 is built on Magento Open Source 2.4.8-p4, released today with a variety of security fixes.

Please check the Magento Open Source 2.4.8 release notes and the 2.4.8 security patch notes for details on upstream changes.

Software	Version
Composer	2.9
OpenSearch	3.x (or Elasticsearch 8.x)
MariaDB	11.4
MySQL	8.4
nginx	1.28
PHP	8.3, 8.4
RabbitMQ	4.1
Redis	Valkey 8 (or Redis 7.2+)
Varnish	7.7

What’s changed

Real column type introspection fix Fixed an issue where setup:db:status and setup:db-schema:upgrade perpetually reported pending modify_column changes for certain DOUBLE UNSIGNED columns. (#205) by @furan917
Mage-OS Admin Theme (m137) updated from 1.3.2 to 1.3.4
- Refactored action-split, page-builder standard/connected buttons to align with Google Material Design 3
- UI improvements to field labels, control spacing, modal messaging, newsletter, and order/shipment styling
- Replaced GIF loader with SVG
PCI 4 Compatibility module updated from 1.3.1 to 1.4.1
- Structural improvements to the session expiry modal
- Fixed z-index to ensure the session expiry modal renders above all other page elements

Mirror updates

The latest Magento versions, including 2.4.8-p4, are also available from our public Magento mirror at mirror.mage-os.org. This mirror is a drop-in replacement for repo.magento.com (except Magento Marketplace), allowing you to install Magento without any login credentials.

Thanks to everyone who contributed!

Thank you to @rhoerr (Ryan Hoerr) and @marcelmtz (Marcel Martinez) for handling this release!

This release was also made possible by the contributions of:

@artKozynets (Artem Kozynets)
@furan917 (Francis Gallagher)
@aligent-lturner (Lachlan Turner, Aligent)

Want to participate?

Installation

New installations

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

Upgrading from a previous Mage-OS version

composer require mage-os/product-community-edition=^2.2 --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.2.0. As always, please report any issues on GitHub and join the conversation on Discord.

Mage-OS 2.1 is out now!

mage-os-team — Mon, 19 Jan 2026 20:55:00 GMT

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:

Software	Version
Composer	2.9.3
OpenSearch	3.x (or Elasticsearch 8.x)
MariaDB	11.4
MySQL	8.4
nginx	1.28
PHP	8.3, 8.4
RabbitMQ	4.1
Redis	Valkey 8 (or Redis 7.2+)
Varnish	7.7

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?

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.

Mage-OS 2.0: Innovation Takes Flight

fabrizio-balliano — Thu, 16 Oct 2025 00:00:00 GMT

We are excited to announce the release of Mage-OS Distribution 2.0, a major milestone that shows the power of community-driven innovation. This release represents a significant step forward in Mage-OS’s commitment to advancing open-source e-commerce.

Our Foundation

Mage-OS 2.0 builds on Magento Open Source 2.4.8-p3, including all the latest security fixes and platform improvements from the upstream release. This ensures that our distribution maintains the solid foundation that hundreds of thousands of developers and merchants worldwide depend on, while adding the improvements that make Mage-OS special.

See recommended software versions

Component	Recommended Version
Composer	2.8
OpenSearch	2.19
MariaDB	11.4
MySQL	8.4
PHP	8.4/8.3
RabbitMQ	4
Redis	Valkey 8 (or Redis 7.2+)
Varnish	7.6
Apache	2.4
nginx	1.26

Version and Support Policy

We adopted a new versioning policy, starting with Mage-OS 1.2 in June. This is our first major update.

#.0.0 Major Updates
- 2x per year, around April/May and October.
- These may include new features, useful bundled extensions, significant changes, or changes to system requirements like PHP versions.
- They should stay mostly compatible with Magento and existing extensions, allowing you to easily switch between Mage-OS and Magento.
2.#.0 Minor Updates
- Any Magento release or security patch between a feature release will become a Mage-OS minor version update, unless there is a change in system requirements.
- These should be compatible with existing installations.
2.0.# Patch Updates
- Small but critical off-schedule fixes to a Mage-OS release. These should be rare.

This reflects our plan for more rapid releases and innovation, and lets everyone know and plan for updates in advance.

Adobe announced plans to release security patches on the second Tuesday of each month in 2026. Mage-OS will publish an update each time with the latest security patches included.

As a mostly-volunteer-run nonprofit, our resources are limited. As such, for now, Mage-OS will only support the latest release branch at a time. You must stay up to date with the latest Mage-OS release to stay secure.

The Mage-OS Lab: Where Innovation Develops

One of the most exciting aspects of Mage-OS 2.0 is that we’ve graduated multiple Mage-OS Lab modules into the core distribution. The Mage-OS Lab is our innovation space, where we welcome everyone in the community to experiment, improve, and perfect new ideas and improvements for the Magento ecosystem.

The Lab represents our future of open-source Magento: collaborative, experimental, and community-driven. It’s where new ideas are tested, improved, and ultimately brought to life for the benefit of the entire ecosystem.

These modules represent months of dedicated work by talented developers who believe in pushing the platform forward.

New Features

Enhanced Security with PCI DSS 4.0 Compliance

Mage-OS 2.0 bundles the aligent/magento2-pci-4-compatibility module, which updates default admin policies for PCI DSS 4.0 requirements. This includes:

Automatic account deactivation after 90 days of inactivity
Enhanced session security with 15-minute idle timeout enforcement
Strengthened authentication with improved lockout policies
More strict password requirements with 12-character minimum length and complexity rules

AI-Powered Automatic Translation

The Automatic Translation module changes how merchants expand globally. This powerful tool uses AI services from DeepL, OpenAI, or Google Gemini to provide:

Product catalog translation with support for both text and select/multiselect attributes
Automated cron-based translation workflows for hands-off operation
Manual translation controls for categories, CMS pages, and static blocks
Intelligent retranslation prevention that respects manual edits while adapting to source changes

Use of AI translation requires a separate AI service account and API key, and will involve costs by usage.

Advanced Inventory Management

The new Inventory Reservations Grid brings better visibility to your inventory management, allowing you to directly see and manage stock reservations in Magento’s inventory system.

SEO Tuning Made Simple

The Meta Robots Tag module gives you detailed control over search engine indexing. With three new attributes in the “Search Engine Optimization” section of products, categories, and CMS pages, you can fine-tune your NOINDEX, NOFOLLOW, and NOARCHIVE tags page by page.

Page Builder Enhancements

Two powerful Page Builder enhancements from Mage-OS Lab are now part of Mage-OS 2:

Embedded Widgets

Page Builder Widgets adds “CMS Widget” support directly into Page Builder, including previews of the widget output. This can be used anywhere Page Builder is supported, including pages, blocks, and content descriptions.

Import/Export and Remote Sync

PageBuilder Template Import/Export enables Page Builder templates to be easily shared between Magento instances. This module supports both local file transfers and cloud-based Dropbox integration for template management workflows across multiple websites or instances.

Performance Optimization

The Theme Optimization module delivers better user experience based on the latest browser features:

Back/Forward Cache (bfcache) support gives almost instant browser navigation backwards/forwards on cacheable pages
Speculative preloading intelligently preloads links before the user clicks them
Smooth page transitions create a premium user experience

All of these combine to give a smoother experience and better Core Web Vitals than without.

Core Platform Improvements

Beyond the new modules, Mage-OS 2.0 includes several important platform improvements developed by our community:

GitHub Pull Request Contributions

Several key contributions from the community have been integrated:

Admin Dashboard JavaScript Fix (#164): Ryan Hoerr resolved a JavaScript error that could occur on admin login.
Config Load Safety Check (#167): ProxiBlue added a config safety check to better handle missing config id values.
Configurable Product Export Fix (#169): Ryan Hoerr fixed product export issues for configurable products with multiple super attributes.
PHP 8.4 Compatibility (#157): aelmizeb fixed PHP 8.4 deprecation errors on compilation.
USPS API Migration (#170): We added Magento patch AC-15210 for support of the USPS REST API. USPS will be turning off the legacy Web Services API on January 26, 2026.

Celebrating Our Community

Mage-OS wouldn’t exist without the support of our growing community. We extend our thanks to our 172 financial contributors who have collectively contributed over €106,000 to fund this mission since 2022. This has gotten us where we are today, but every bit more will help us to do more faster. Please add your support and help us do something great!

Our Partner Ecosystem

Gold Partners (€10,000/year):

MDOQ - Leading the way with €20,000 in total contributions
Interactiv4 - Our first Gold Partner with €10,000 contributed

Silver Partners (€4,000/year):

ParadoxLabs
Hyvä Themes
Vendic
Inchoo
Mollie
WilMa Digital

Bronze Partners (€1,250/year):

JetRails, Develo, FindCanary, JH, integer_net, and basecom

We also celebrate our 81 Community Members and 67 Professional Members who power the grassroots support that makes everything possible.

Special Recognition

Thank you to the people who made Mage-OS 2.0 possible:

Davide Lunardon, Luca Fuser, and Samuele Martini for the Automatic Translation and PageBuilder modules
Ryan Hoerr, Oliver Jaufmann/JaJuMa GmbH, Sean van Zuidam, and David Lambauer for the Theme Optimization module
The Aligent team for their PCI 4.0 Compatibility module
Ryan Hoerr and Fabrizio Balliano for multiple platform fixes and release management
ProxiBlue and aelmizeb for their platform improvements

And to the many more that participated, tested, commented, worked in Mage-OS Lab, or otherwise supported our efforts.

Join the Community

Do you want to be part of the future of e-commerce?

The success of Mage-OS depends on community support and involvement. Whether you’re a developer, merchant, agency, or technology partner, we need you.

For Individuals

Community Member: €10/year - Show your support and get voting rights
Professional Member: €100/year - For those making a living with the platform

For Businesses

Bronze Partner: €1,250/year - Perfect for small companies
Silver Partner: €4,000/year - Includes logo placement on Mage-OS.org
Gold Partner: €10,000/year - Premium visibility and partnership benefits
Platinum Partner: €25,000/year - Be the first! Maximum impact and recognition

Become a sponsor today: mage-os.org/about/mage-os-membership

Get Involved in Development

Join our weekly tech meetings every Tuesday at 3 PM CET on Discord. Contribute to the Mage-OS Lab, submit pull requests, or share your ideas with the community.

Repository: github.com/mage-os/mageos-magento2
Lab Projects: github.com/mage-os-lab
Community Chat: chat.mage-os.org

If you have an Open Source module you are interested in including or contributing, get in touch!

Installing Mage-OS 2.0

Ready to experience the future? Create a new Mage-OS project with:

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

Upgrading from Magento

You can convert from Magento to Mage-OS with one line (sort of):

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 update --no-plugins --with-all-dependencies

We recommend updating to the latest available Magento version before switching to Mage-OS, to make the process as smooth as possible.

The Future

Mage-OS 2.0 represents more than just a software release, it’s proof that community-driven innovation works. Every module that graduated from the Lab, every security enhancement, and every performance improvement exists because dedicated developers and forward-thinking businesses chose to invest in the future of open-source e-commerce.

This is just the beginning. With your support, Mage-OS will continue to evolve, innovate, and lead the way toward a more accessible, powerful, and community-controlled e-commerce future.

Welcome to Mage-OS 2.0. Welcome to the future of e-commerce.

For complete installation instructions and technical details, visit devdocs.mage-os.org. Join our community discussions on Discord, and follow our progress on GitHub.

Mage-OS 1.3.1: Important security update

fabrizio-balliano — Tue, 09 Sep 2025 00:00:00 GMT

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

Mage-OS 1.3.1 is built on Magento Open Source 2.4.8-p2, and includes an important security update from Magento Open Source that was released just this morning.

This update fixes vulnerability CVE-2025-54236, by applying the official Adobe security patch to Mage-OS. There are no other changes from Mage-OS 1.3.0.

Security Bulletin: APSB25-88
Magento Security Patch: Action Required: Critical Security Update Available for Adobe Commerce  (APSB25-88)

Please update any Mage-OS instances to version 1.3.1 as soon as possible to prevent security issues.

composer require mage-os/product-community-edition:1.3.1
bin/magento setup:upgrade

If you have Magento or Adobe Commerce, you will need to apply the Adobe security patch available through the link above.

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.

Mage-OS 1.3.0 is out now!

fabrizio-balliano — Fri, 15 Aug 2025 00:00:00 GMT

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

Our foundation

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

The latest recommended software versions are:

Composer	2.8
Elasticsearch	— (no longer supported)
OpenSearch	2.19
MariaDB	11.4
MySQL	8.4
PHP	8.4/8.3
RabbitMQ	4
Redis	Valkey 8 (or Redis 7.2+)
Varnish	7.6
Apache	2.4
nginx	1.26

Updates to our backend theme

In this release, we enhanced the user interface with improved icon styling, refined newsletter and email template views, optimized data grids and modals, updated jstree components and media galleries, refactored URL rewrites, and fixed LESS configuration issues for greater usability.

Other updates

Fixed JavaScript error encountered when selecting “All Resources” by Lucas van Staden
Fixed integration tests for Magento_Backend and Magento_Bundle by Simon Humeau (Antadis)
Fixed missing screen-l styles added using .media-width mixin by Vova Yatsyuk
Fixed city name validation to allow digits, &, ., () characters by Bhushan Kumar

Thanks to everyone that helped with this release!

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

Artem Kozynets
Bhushan Kumar
Fabrizio Balliano
Lucas van Staden
Ryan Hoerr
Simon Humeau (Antadis)
Vinai Kopp
Vova Yatsyuk

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.

Mage-OS 1.2.0 is out now!

fabrizio-balliano — Wed, 18 Jun 2025 00:00:00 GMT

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:

Composer	2.8
Elasticsearch	— (no longer supported)
OpenSearch	2.19
MariaDB	11.4
MySQL	8.4
PHP	8.4/8.3
RabbitMQ	4
Redis	Valkey 8 (or Redis 7.2+)
Varnish	7.6
Apache	2.4
nginx	1.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.

Mage-OS 1.1: A new admin experience, and so much more!

fabrizio-balliano — Tue, 15 Apr 2025 00:00:00 GMT

We are excited to announce the release of Mage-OS Distribution 1.1.0, a milestone in the development of our community project!

This release packs one huge change, some major ones and many minor security improvements, for the biggest release we’ve ever had!

But first of all, let’s start with…

Our foundation

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

As part of that, Mage-OS 1.1 adds support for PHP 8.4, drops support for PHP 8.1, and requires OpenSearch 2.x going forward.

The latest recommended software versions are:

Composer	2.8
Elasticsearch	— (no longer supported)
OpenSearch	2.19
MariaDB	11.4
MySQL	8.4
PHP	8.4/8.3
RabbitMQ	4
Redis	Valkey 8 (or Redis 7.2+)
Varnish	7.6
Apache	2.4
nginx	1.26

A new backend experience

Thanks to the hard work of Artem Kozynets, one of the members of our community, we’re proud to announce that Mage-OS 1.1 includes a completely redesigned theme for the admin panel!

This is not just a quick style, it’s a complete design system inspired by Material Design 3. The design system is available for you to preview and use on Figma. We would like to extend a huge thank you to Artem for all of his effort and dedication here.

This is such a big change that we’ve dedicated a full blog post to it!

Major performance improvements

In addition to the new admin theme, we’ve chosen to bundle the Creatuity Compiled Interceptors open source module. Thank you to Franciszek Wawrzak for his tireless work creating and maintaining this solution.

This module changes the way Magento 2 generates Interceptor classes (a mechanism that allows plugins to work together), to make plugins faster to execute. This is a drop-in replacement for Magento’s normal interceptor classes. In the process, since Magento uses a lot of plugins, including this lowers the production TTFB (response times) by an average of 10%!

Security improvements and bugfix

Magento 2.4.8 allows for disclosing of all catalog/sales promotion rules, and customer groups, via GraphQL API calls. We believe these details should stay private unless merchants opt in to sharing them. Thanks to Damien Retzinger, Mage-OS 1.1.0 disables these calls.

We also found an error in the calculation of the lowest price of a products when child products are out of stock… and fixed it thanks to Melinda Humphrey.

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
Franciszek S Wawrzak
Lucas van Staden
Melinda Humphrey
Ryan Hoerr
Tjitse Efdé
Vinai Kopp

Along with recent Mage-OS Lab contributors:

Antonio Carboni
Christian Münch
Davide Lunardon
Jakub winkler
Luca Fuser
Nils Preuß
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.

Release: Mage-OS Distribution 1.0.6

fabrizio-balliano — Thu, 13 Feb 2025 00:00:00 GMT

We are excited to announce the release of Mage-OS Distribution 1.0.6!

Release Notes

This release achieves full parity with Magento Open Source 2.4.7-p4, which incorporates critical platform security enhancements.

Please check the release notes for Magento Open Source 2.4.7 and the patch notes for 2.4.7-p4.

You can get Mage-OS from our primary composer repository, repo.mage-os.org.

What’s Changed

Full Changelog: 1.0.5…1.0.6

Thanks to everyone that helped with this release! Including: Fabrizio Balliano, Ryan Hoerr, Vinai Kopp, Lucas van Staden, Francis Gallagher, Tu Van, Peter Jaap Blaakmeer.

Mirror Updates

The latest Magento versions are also available from our public Magento mirror, mirror.mage-os.org:

2.4.4-p12
2.4.5-p11
2.4.6-p9
2.4.7-p4

This mirror composer repository is a drop-in replacement for Magento packages from repo.magento.com. This way you can install Magento without any login, using our public and repeatable build process from the official Magento sources.

Contribute

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 summarize 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.1+, 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.7-p2) 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.

What’s Next?

Our Vision for Mage-OS

The Mage-OS Distribution is an upstream compatible metapackage based on Magento Open Source. Think of it as an independent version of Magento—based on Magento source code, but including additional changes specific to Mage-OS.

The purpose of the Mage-OS core distribution is to provide

Improved decoupling of packages
Improved developer experience while working with the product
Improved developer experience while contributing to the product
Full compatibility with Magento extensions
Focus on additional security
Reduced infrastructure stack dependencies
Low-level code improvements, for example in the areas of caching and indexing
Removal of most bundled extensions contained in upstream (still independently installable if desired)
A simple documented migration path to Magento Open Source or Adobe Commerce

Mage-OS Distribution releases are made independently of upstream releases. This enables us to move faster when desired, for example when enabling compatibility with new PHP versions.

New functional features will be introduced through independently installable modules. This follows the same decoupling approach that Adobe Commerce is using, allowing for a more stable core and an independent feature module release schedule.

The goal of the reduced infrastructure stack dependencies is to enable new developers to be onboarded more easily. The goal is to be able to use a plain XAMPP stack on any machine, including Windows, to run and develop with Mage-OS. This requires making Elasticsearch optional, as well as ensuring services like Redis, RabbitMQ, Node.js and such remain optional.

Mage-OS will also maintain backwards compatibility and the ability to migrate upstream at multiple levels:

Compatibility with third-party extensions
Database level compatibility (data and schema)
API stability

All of our work on creating custom releases based on Magento is open source, meaning:

Mage-OS builds can be independently built and verified, and are fully reproducible;
If you want to create your own fork and version of Magento or Mage-OS, you can do that too.

That’s all for now!

Release: Mage-OS Distribution 1.0.5

fabrizio-balliano — Wed, 06 Nov 2024 00:00:00 GMT

We are excited to announce the release of Mage-OS Distribution 1.0.5!

Release Notes

This release achieves full parity with Magento Open Source 2.4.7-p3, which incorporates critical platform security enhancements.

Please check the release notes for Magento Open Source 2.4.7 and the patch notes for 2.4.7-p3.

You can get Mage-OS from our primary composer repository, repo.mage-os.org.

What’s Changed

Full Changelog: 1.0.4…1.0.5

Mirror Updates

The latest Magento versions are also available from our public Magento mirror, mirror.mage-os.org:

2.4.4-p11
2.4.5-p10
2.4.6-p8
2.4.7-p3

Contribute

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 summarize 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.1+, 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.7-p2) 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.

What’s Next?

Our Vision for Mage-OS

The purpose of the Mage-OS core distribution is to provide

Improved decoupling of packages
Improved developer experience while working with the product
Improved developer experience while contributing to the product
Full compatibility with Magento extensions
Focus on additional security
Reduced infrastructure stack dependencies
Low-level code improvements, for example in the areas of caching and indexing
Removal of most bundled extensions contained in upstream (still independently installable if desired)
A simple documented migration path to Magento Open Source or Adobe Commerce

Mage-OS Distribution releases are made independently of upstream releases. This enables us to move faster when desired, for example when enabling compatibility with new PHP versions.

Mage-OS will also maintain backwards compatibility and the ability to migrate upstream at multiple levels:

Compatibility with third-party extensions
Database level compatibility (data and schema)
API stability

All of our work on creating custom releases based on Magento is open source, meaning:

Mage-OS builds can be independently built and verified, and are fully reproducible;
If you want to create your own fork and version of Magento or Mage-OS, you can do that too.

That’s all for now!

Release: Mage-OS Distribution 1.0.4

mage-os-team — Thu, 22 Aug 2024 00:00:00 GMT

We are proud to announce Mage-OS Distribution version 1.0.4 is now available!

Release Notes

This Mage-OS update brings parity with Magento Open Source 2.4.7-p2, which was recently released with platform security fixes. When upgrading from an earlier version, please be sure to rotate your encryption key.

Please see the release notes for Magento Open Source 2.4.7 and the patch notes for 2.4.7-p2.

You can get Mage-OS from our primary composer repository, repo.mage-os.org.

What’s Changed

Security changes from upstream 2.4.7-p2 by @rhoerr in #101

Full Changelog: 1.0.3…1.0.4

Mirror Updates

The latest Magento versions are also available from our public Magento mirror, mirror.mage-os.org:

2.4.4-p10
2.4.5-p9
2.4.6-p7
2.4.7-p2

Contributors

Thank you to Ryan Hoerr for managing this release, and to all that contributed to the Magento Open Source security reports and fixes.

Thank you also to all who attend our weekly tech meetings, and to all who have ongoing efforts underway!

Contribute

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 summarize 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.1+, 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.7-p2) 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.

What’s Next?

Our Vision for Mage-OS

The purpose of the Mage-OS core distribution is to provide

Improved decoupling of packages
Improved developer experience while working with the product
Improved developer experience while contributing to the product
Full compatibility with Magento extensions
Focus on additional security
Reduced infrastructure stack dependencies
Low-level code improvements, for example in the areas of caching and indexing
Removal of most bundled extensions contained in upstream (still independently installable if desired)
A simple documented migration path to Magento Open Source or Adobe Commerce

Mage-OS Distribution releases are made independently of upstream releases. This enables us to move faster when desired, for example when enabling compatibility with new PHP versions.

Mage-OS will also maintain backwards compatibility and the ability to migrate upstream at multiple levels:

Compatibility with third-party extensions
Database level compatibility (data and schema)
API stability

All of our work on creating custom releases based on Magento is open source, meaning:

Mage-OS builds can be independently built and verified, and are fully reproducible;
If you want to create your own fork and version of Magento or Mage-OS, you can do that too.

That’s all for now!

Release: Mage-OS Distribution 1.0.3

ryan-hoerr — Thu, 25 Jul 2024 00:00:00 GMT

We are proud to announce Mage-OS Distribution version 1.0.3 is now available!

Release Notes

This Mage-OS update brings parity with Magento Open Source 2.4.7 and 2.4.7-p1, plus additional contributions particularly to the unit and integration testing suites.

Please see the release notes for Magento Open Source 2.4.7 and the patch notes for 2.4.7-p1.

What’s Changed

Changes and fixes from upstream 2.4.7
Security changes from upstream 2.4.7-p1 by @rhoerr in #98
GitHub Actions
- Add inputs to mage-os/github-actions/coding-standard-baseline by @Tjitse-E in #59
- Add full integration tests workflow by @vpodorozh in #57
- Add Nx integration tests by @adamzero1 in #64
Unit and Integration Test Fixes
- Integration tests/ fix failed tests by @vpodorozh in #61
- Resolve merge conflicts by @Vinai in #87
- Update incorrect dataprovider for Catalog\SortingTest by @vpodorozh in #89
- GraphQl mutation state check | PlaceOrder and Customer actions - skip list adjustments by @vpodorozh in #90
- Skip some of the Bundle tests as the underlying problems are too big … by @vpodorozh in #92
- Fix expireDate formating for integration test by @vpodorozh in #91
- #79 - add shutdown functions wrapper to make sure TestModules will be… by @vpodorozh in #93
- Fix failed tests after the upstream update - db&app isolation were missed by @vpodorozh in #94
- Fix invalid data-sets for unit tests by @vpodorozh in #95
Resolve merge conflict https://github.com/mage-os/mageos-magen… by @vitaliy-golomoziy in #58

Full Changelog: 1.0.1…1.0.3

Contributors

@vitaliy-golomoziy made their first contribution in #58
@vpodorozh made their first contribution in #57

Thank you to all that contributed toward this release, including:

Adam Crossland
Christian Münch
Damien Retzinger
Ihor Sviziev
Jakub Winkler
Max Novik
Ryan Hoerr
Simon Sprankel
Tjitse Efdé
Vinai Kopp
Vladyslav Podorozhnyi

Thank you also to all who attend our weekly tech meetings, and to all who have ongoing efforts underway!

Contribute

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 summarize 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.1+, 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.7-p1) 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.

What’s Next?

Our Vision for Mage-OS

The purpose of the Mage-OS core distribution is to provide

Improved decoupling of packages
Improved developer experience while working with the product
Improved developer experience while contributing to the product
Full compatibility with Magento extensions
Focus on additional security
Reduced infrastructure stack dependencies
Low-level code improvements, for example in the areas of caching and indexing
Removal of most bundled extensions contained in upstream (still independently installable if desired)
A simple documented migration path to Magento Open Source or Adobe Commerce

Mage-OS Distribution releases are made independently of upstream releases. This enables us to move faster when desired, for example when enabling compatibility with new PHP versions.

Mage-OS will also maintain backwards compatibility and the ability to migrate upstream at multiple levels:

Compatibility with third-party extensions
Database level compatibility (data and schema)
API stability

All of our work on creating custom releases based on Magento is open source, meaning:

Mage-OS builds can be independently built and verified, and are fully reproducible;
If you want to create your own fork and version of Magento or Mage-OS, you can do that too.

That’s all for now!

Introducing the Mage-OS Distribution

mage-os-team — Mon, 09 Oct 2023 00:00:00 GMT

We are proud to announce version 1 of the Mage-OS Distribution!

This release is based on Magento 2.4.6-p3, plus additional contributions including a refreshed admin panel. We will continue making enhancements over time, as they’re contributed by the open source community.

Because they’re based on the same code, all of your existing Magento extensions will work with Mage-OS too!

UPDATE 2023-10-11: With the release of Magento security patch 2.4.6-p3 today, we’ve also published Mage-OS Distribution 1.0.1.

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.1+, 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.6-p3) 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.

Release Notes

This release is based on Magento 2.4.6-p3, plus community contributions merged since. It also includes the following Mage-OS-specific changes:

Removed adobe-commerce/adobe-ims-metapackage, magento/adobe-stock-integration, magento/google-shopping-ads, paypal/module-braintree, temando/module-shipping (thanks to Vinai Kopp)
Admin theme Mage-OS re-brand (thanks to Ryan Hoerr)
Mage-OS brand logo and name changes (thanks to Kiel Pykett)
Fixed Maestro Domestic CC detection pattern to prevent false positives (thanks to Ryan Hoerr)
Increased the default max admin session size to 1 MB (thanks to Ryan Hoerr, and Maciej Tomaszewski and others involved on the upstream discussions)
Faster category product count (thanks to Damien Retzinger, and Vincent Enjalbert who created the original upstream PR)

Huge thank you to everyone that has contributed to the Mage-OS infrastructure, tests, actions, and more to get us here, including:

Vinai Kopp
Damien Retzinger
Daniel Sloof
Adam Crossland
Tjitse Efdé
Gowri Sankar
Vitaliy Golomozy
David Lambauer
Simon Sprankel
Kamlesh Luhana
Kiel Pykett
Christian Münch
Fabian Schmengler
Vladyslav Podorozhnyi
and so many more

What’s Next?

Our Vision for Mage-OS

The purpose of the Mage-OS core distribution is to provide

Improved decoupling of packages
Improved developer experience while working with the product
Improved developer experience while contributing to the product
Full compatibility with Magento extensions
Focus on additional security
Reduced infrastructure stack dependencies
Low-level code improvements, for example in the areas of code generation and caching
Removal of most bundled extensions contained in upstream (they can still be independently installed if desired)
A simple documented migration path to Magento Open Source or Adobe Commerce

Mage-OS Distribution releases are made independently of upstream releases. This enables us to move faster when desired, for example when enabling compatibility with new PHP versions.

Mage-OS will also maintain backwards compatibility and the ability to migrate upstream at multiple levels:

Compatibility with third-party extensions
Database level compatibility (data and schema)
API stability

All of our work on creating custom releases based on Magento is open source, meaning:

Mage-OS builds can be independently built and verified, and are fully reproducible;
If you want to create your own fork and version of Magento or Mage-OS, you can do that too.

Up Next: Mage-OS Flavored Distributions

Soon, we will be working toward producing different ‘flavors’ of Mage-OS. These flavors will be different bundles of Mage-OS packages, for specific purposes. For example:

The Mage-OS headless distribution might contain no storefront theme
The Mage-OS minimal distribution might contain only a minimal set of packages to enable building lightweight applications
The Mage-OS headful distribution might contain no GraphQL packages

Fundamentally these will be the same Mage-OS/Magento you’ve come to know and love, but without features that don’t apply to a given use case — and maybe with additional features that use case uniquely benefits from. In the process, Mage-OS will become more performant, more flexible, and appeal to an even broader market.

Our goal is also to allow others to create their own ‘distributions as ‘flavored’ distributions too.

Contribute

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

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

That’s all for now!

Magento 2.4.6 Release

ryan-hoerr — Sun, 26 Mar 2023 00:00:00 GMT

The recently-released Magento 2.4.6 (along with 2.4.5-p2, and 2.4.4-p3) is now available on all Mage-OS mirror and distribution repositories. We had to delay the release briefly because of a missing release tag on one of the upstream Magento repositories, which we reported and has since been corrected.

If you’re interested in using a Mage-OS repository, please see the Mage-OS Distribution page!

Currently all packages are exact copies of the official Magento packages for each release. This will change as soon as we release our own Mage-OS Distribution.

Mage-OS Association Progress

We are making progress on establishing the Mage-OS Association. Recently the Polish court fully approved and filed the association in the national registry. We are now working through legal steps for handling of taxes, opening a bank account, and choosing an accountant. We expect to open membership and finances as soon as those steps come together.

Magento 2.4.5-p1 release

mage-os-team — Tue, 11 Oct 2022 00:00:00 GMT

Adobe has released updates to Magento Open Source today, versions 2.4.5-p1 and 2.4.4-p2.

Those same updates are now also available if you’re using our Magento mirror composer repository, mirror.mage-os.org. Our validation has confirmed the mirror releases are installable and match the official releases.

Thanks to Vinai Kopp and Damien Retzinger for managing the release process.

If you’re not yet using the Mage-OS Magento mirror, you can do that today by swapping repo.magento.com to mirror.mage-os.org in your composer.json (unless you require any Magento Marketplace packages). This is a public repository, built by our independent open source build process from the Magento 2 source code. For more info on the Mage-OS nightly and mirror repositories, see: https://mage-os.org/distribution

We have plans to launch the Mage-OS Distribution and start accepting pull requests by the end of this year. Stay tuned for more!

Mirror 2.4.5 release and many contributions

mage-os-team — Mon, 15 Aug 2022 00:00:00 GMT

Work has been progressing nicely, and we celebrate that more people are getting involved! Here is an overview of what has been happening since the last blog post.

Technical topics

Mage-OS Magento® Mirror Distribution

Adobe released Magento Open Source 2.3.7-p4, 2.4.3-p3, 2.4.4-p1 and 2.4.5 on the 9th of August! We are pleased to announce that these versions can now also be installed as independently built packages, using the Mage-OS mirror.

While preparing the releases, we discovered (very few) inconsistencies in upstream composer.json files that broke our build process. We reported these inconsistencies upstream to Adobe (for example in the security package and adobe-stock-integration repositories), and they are being addressed. At the same time, we have improved the build tool to account for these issues allowing Mage-OS to become more independent.

Finally, Damien Retzinger from Graycore contributed GitHub actions to automate testing builds in parallel. This allowed us to move much, much faster, and we are very grateful for his participation!

Daniel Sloof created GitHub actions to check the integrity of the Mage-OS packages against the upstream releases. This QA tooling is invaluable.

Many thanks to Damien and Daniel, and to all others like Anton, Daniel Fahlke and many others who participated in discussions and helped with good ideas in the #tech channel or joined a stream on Discord.

Mage-OS Magento® Mirror Nightly Builds

The new versioning scheme for the nightly build packages, as discussed in the previous post, has been implemented, and is currently being evaluated, if it indeed serves the desired purpose.
We expect the nightly builds to be available soon.

Contributing

People have been asking how to contribute. It is very encouraging to see that many people want to help, and so far we still don’t have a good answer.

Since we are currently “meta-building”, instead of building Magento features and improvements, we are in a bit of a special situation. We expect this to change once the infrastructure for the mirror, nightly builds, and the Mage-OS distribution is closer to complete.

The usual approach to encouraging contributions to open source projects is to do “Issue grooming” and then to choose tickets that are good first issues. This approach is not applicable (yet) to the Mage-OS project.

At the moment, most people have started by joining Discord, following the #tech channel, and joining streams in the #Watercooler channels, where problems are being discussed and solved together.

It has been very valuable to interact in this way.

Currently, this is the best way to get started, as it helps develop an understanding of what is required at a given moment in time, be it debugging, writing code, pairing or coming up with ideas.

So if you are interested in helping, join a stream in Discord and get an idea what is happening. It is fun, too, if you like problem-solving and coding :)

For those who simply wish to keep up, start by following the discord #tech channel.

We are welcoming and inclusive at chat.mage-os.org!

Organizational topics

Mage-OS Association

Vacation season is keeping us busy, but we are moving to complete the founding of the association.

We will form a committee to set the price for members and supporting members (companies).
If you would like to be involved, please join the Mage-OS Discord #membership channel and let us know!

For now that’s all, more updates are coming soon.

The Mage-OS folks