Download the latest Mage-OS Distribution and explore our complete release history below.
One of our most significant feature releases, going deeper into AI: an admin AI assistant, AI discoverability, built-in SEO and structured data, passwordless passkey login, native product feeds, and a substantial overhaul of Multi-Source Inventory.
Read the full release notesCreate 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.
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
ReleasesOne of our most significant feature releases, going deeper into AI: an admin AI assistant, AI discoverability, built-in SEO and structured data, passwordless passkey login, native product feeds, and a substantial overhaul of Multi-Source Inventory.
ReleasesSecurity Port of Adobe's October isolated patch (APSB26-153). This release includes fixes for security issues rated CVSS 10.0. All 3.x users should upgrade.
ReleasesPorts Adobe's hotfix for StyleSmuggler (CVE-2026-75650, CVSS 10.0), an unauthenticated RCE exploited in the wild since 4 September. Upgrade immediately — and read the remediation steps, because patching alone is not enough.
As a community-run organization, Mage-OS provides security patches and updates for the latest release branch only. Older releases receive no fixes, so upgrading promptly is essential to keep your store secure.
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.
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:flushMigrating 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.
| Resource | URL |
|---|---|
| Composer Repository | https://repo.mage-os.org/ |
| GitHub Source | github.com/mage-os/mageos-magento2 |
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.
| Resource | URL |
|---|---|
| Composer Repository | https://repo.mage-os.org/ |
| Package Browser | mage-os.org/product/minimal |
composer create-project --repository-url=https://repo.mage-os.org/ mage-os/project-minimal-edition .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 |
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.
| Build | Composer Repository | Tracks |
|---|---|---|
| Mage-OS Nightly | nightly.mage-os.org | Latest development state of Mage-OS Distribution |
| Upstream Nightly | upstream-nightly.mage-os.org | Latest development state of upstream Magento Open Source |
Mage-OS Nightly is useful for:
Upstream Nightly is useful for:
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 .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/ |
| 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/ |
| Resource | URL |
|---|---|
| Developer Docs | devdocs.mage-os.org |
| Docs GitHub | github.com/mage-os/devdocs |
Mage-OS releases are made possible by our global community of contributors. Special thanks to:
View all contributors | Become a contributor
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 |
