ReleasesMage-OS 2.2.2 – Bug Fixes & Compatibility Improvements
Mage-OS 2.2.2 brings PHP 8.2 compatibility for Automatic Translation, bug fixes across several modules, and a refined GraphQL dependency constraint.
Product
Releases
Download the latest Mage-OS Distribution and explore our complete release history below.
Latest Release
Mage-OS 2.2.2 – Bug Fixes & Compatibility Improvements
Mage-OS 2.2.2 brings PHP 8.2 compatibility for Automatic Translation, bug fixes across several modules, and a refined GraphQL dependency constraint.
Read the full release notesQuick 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 2.4.8+ store to Mage-OS with our automated migration script:
bash <(curl -s https://raw.githubusercontent.com/mage-os-lab/migrate-m2-to-mageos/refs/heads/main/migrate-to-mage-os.sh)Full Installation Guide | Migration Guide | System Requirements
Recent Releases
View all releases » Releases ReleasesMage-OS 2.2.1 – Security & Stability Patch
Mage-OS 2.2.1 is a patch release addressing a GraphQL API breaking change, a checkout reCAPTCHA regression, and a critical upload vulnerability.
ReleasesMage-OS 2.2 is out now!
Mage-OS 2.2.0 adds important security patches from Magento Open Source 2.4.8-p4, along with bug fixes and UI improvements.
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:flushFrom 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
| Resource | URL |
|---|---|
| Composer Repository | https://repo.mage-os.org/ |
| GitHub Source | github.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.
| Resource | URL |
|---|---|
| GitHub Organization | github.com/mage-os-lab |
Magento Mirrors
Mage-OS provides public Magento Open Source mirrors for installing Magento without Adobe Marketplace authentication:
| Region | Mirror 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
| Resource | URL |
|---|---|
| Developer Docs | devdocs.mage-os.org |
| Docs GitHub | github.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?
| Action | Link | Description |
|---|---|---|
| Quick Start | Get Started | Install Mage-OS in 30 minutes |
| System Requirements | View Requirements | Check your server compatibility |
| Migration Guide | Migrate Now | Switch from Magento Open Source |
| Features | Explore Features | See what makes Mage-OS different |
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
