Releases

Version Support

As a volunteer-run nonprofit, Mage-OS currently supports only the latest release branch. We recommend staying up to date to ensure you have the latest security patches and features.

Security Patch Schedule

Adobe releases security patches on the second Tuesday of each month ("Patch Tuesday"). Mage-OS typically publishes corresponding updates within days of each Adobe release to incorporate the latest security fixes.

Upgrading

From a Previous Mage-OS Version

Upgrade your existing Mage-OS installation to the latest version:

# Step 1: Update packages
composer update mage-os/product-community-edition --with-all-dependencies

# Step 2: Run database migrations
bin/magento setup:upgrade

# Step 3: Compile dependency injection
bin/magento setup:di:compile

# Step 4: Deploy static content
bin/magento setup:static-content:deploy -f

# Step 5: Clear cache
bin/magento cache:flush

From Magento Open Source

Migrating from Magento to Mage-OS is straightforward and typically takes 15-30 minutes. Your existing extensions, themes, and customizations remain compatible.

See the Migration Guide for step-by-step instructions.

Repositories

Main Distribution

Minimal Distribution

The Minimal Distribution is a metapackage (mage-os/project-minimal-edition) that requires only the core packages needed for a functional store. It is served from the same repo.mage-os.org repository as the main distribution — you add additional modules via Composer as your store needs them. See the Minimal Distribution page to browse all available packages.

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

Mage-OS Lab

Experimental features and community innovations are developed in Mage-OS Lab before being included in the main distribution.

Nightly Builds

Nightly builds are auto-generated every night from the latest development branches. They are intended for developers who want to test against upcoming changes — not for production use.

Mage-OS Nightly is useful for:

• Extension authors testing compatibility with in-flight Mage-OS changes
• QA contributors verifying open pull requests
• Community members who want early access to upcoming features

Upstream Nightly is useful for:

• Developers tracking what Adobe is building before it ships
• Forward-compatibility testing of extensions against the next Magento release

Install via Composer:

# Mage-OS Nightly
composer create-project --repository-url=https://nightly.mage-os.org/ mage-os/project-community-edition:@alpha .

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

Magento Mirrors

Mage-OS provides public Magento Open Source mirrors for installing Magento without Adobe Marketplace authentication:

Documentation

Acknowledgments

Mage-OS releases are made possible by our global community of contributors. Special thanks to:

• Code Contributors - Pull request authors and reviewers
• Lab Developers - Creators of experimental features and innovations
• QA Volunteers - Testing and quality assurance
• Documentation Writers - Keeping our docs accurate and helpful
• Financial Supporters - Partners and sponsors who fund development

View all contributors | Become a contributor

Get Started Today

Ready to try the latest Mage-OS release?

Need Help?

• Community Support: Join our Discord server for real-time help
• Documentation: Browse devdocs.mage-os.org for technical guides
• GitHub Issues: Report bugs at github.com/mage-os/mageos-magento2