Skip to main content

Product

Releases

Download the latest Mage-OS Distribution and explore our complete release history below.

Latest Release

Mage-OS 2.0: Innovation Takes Flight

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...

Read the full release notes

Quick Install (New Project)

Create a fresh Mage-OS installation with a single command:

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

After Composer finishes, run the installer to complete setup. See the Full Installation Guide for detailed steps.

Migrate from Magento Open Source

Switch your existing Magento store to Mage-OS:

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

Tip: We recommend updating to the latest Magento version before migrating to minimize compatibility issues.

Full Installation Guide | Migration Guide | System Requirements

All Release Announcements

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.

Why upgrade regularly? Security patches address vulnerabilities that could put your store and customer data at risk. Staying current is the best way to protect your business.

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

Before upgrading: Always back up your database and files before performing any upgrade. Test the upgrade in a staging environment first.

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

ResourceURL
Composer Repositoryhttps://repo.mage-os.org/
GitHub Sourcegithub.com/mage-os/mageos-magento2

Mage-OS Lab

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

ResourceURL
GitHub Organizationgithub.com/mage-os-lab

Magento Mirrors

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

RegionMirror URL
EU (Primary)mirror.mage-os.org
EU (Hypernode)mage-os.hypernode.com/mirror/
EU (maxcluster)mage-os.maxcluster.net/mirror/
UK (Sonassi)mirror.sonassi.com
US (Breeze)mage-os-usa.breeze.io/mirror/
US (JetRails)mage-os-repo.jetrails.com/mirror/
IN (Breeze)mage-os-india.breeze.io/mirror/

Documentation

ResourceURL
Developer Docsdevdocs.mage-os.org
Docs GitHubgithub.com/mage-os/devdocs

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?

ActionLinkDescription
Quick StartGet StartedInstall Mage-OS in 30 minutes
System RequirementsView RequirementsCheck your server compatibility
Migration GuideMigrate NowSwitch from Magento Open Source
FeaturesExplore FeaturesSee what makes Mage-OS different

Need Help?

Our Partners

MDOQMDOQParadoxLabsParadoxLabsVendicVendicHyväHyväInchooInchooJetRailsJetRailsDeveloDeveloFindCanaryFindCanaryinteger_netinteger_netJHJH
Become a Partner