About the Mage-OS Distribution

Mage-OS is an upstream compatible, lightweight composition of Magento Open Source packages. Some packages will contain changes, and some will be entirely new. We aim to keep the Mage-OS Distribution compatible with all existing Magento 2 extensions and integrations to the greatest extent possible.

What differentiates Mage-OS from Magento Open Source and Adobe Commerce?

  • Independent and community-driven
  • More accessible to new users, developers, and contribution
  • Lightweight package selection by default
  • Simple migration to and from Magento Open Source

Read our product vision for the Mage-OS Distribution


We have not yet published a Mage-OS distribution release, but we hope to soon.

Magento™ Nightly Builds

For the first time ever, you can install a nightly build of Magento’s latest published development source code, without having to wait for an official beta release. Mage-OS’s upstream-nightly composer repository is updated each day with the latest code from the Magento github.

We hope this will be useful for vendors and extension providers to track compatibility of their products with upcoming releases.

Keep in mind that the nightly release might be broken sometimes, depending on the state of the code in the upstream Magento git repositories.

To install our latest nightly build of Magento Open Source in your working directory:

composer create-project --stability alpha --repository-url=https://upstream-nightly.mage-os.org magento/project-community-edition .

Magento™ Mirrors

You can obtain Magento packages through these Mage-OS-built Magento mirror repositories for composer:

These can be used to install Magento Open Source 2.3.7 and 2.4.x without authentication. To install magento/project-community-edition 2.4.6 in your working directory:

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

Magento Mirror Repository Generation

You can create your own Magento mirror with self-built packages, using the mirror repository generator found at github.com/mage-os/generate-mirror-repo-js.

Generating from scratch takes about 1.5 hours on a low-end server (2G RAM, no swap). We are actively improving the tool to make it faster and more usable, however, we expect alternative implementations to be the primary tooling in the future for performance reasons. The current JavaScript-based implementation was started as a research project into minimizing dependencies.

If you publish a mirror, please let us know to add it to the list above!

Dev Docs

Mage-OS is currently undertaking a complete re-write of the Magento Open Source Developer Documentation.

If you are looking for technical guidance on the platform you will find it here:

If you would like to help with this project please get involved!


Mage-OS is community maintained and community developed, so to some extent the direction depends on what people contribute.

Our first priority is to get an independent distribution live, then iterate on that to improve simplicity and performance in a backwards-compatible way.

Stay tuned, or start contributing to help set the roadmap!