Mage-OS: wat is het en voor wie is het zinvol?

Mage-OS is een gratis, door de community beheerde distributie van Magento Open Source. De huidige versie is 3.6.0 (14 oktober 2026), gebouwd op Magento Open Source 2.4.9. Hieronder lees je wie erachter zit, wat het anders doet dan Adobe, hoe je overstapt en wanneer je het beter niet doet.

Wat is Mage-OS?

Mage-OS is Magento Open Source met een eigen release-proces, een eigen Composer-repository en een aantal extra modules. Het is geen herbouw en geen nieuw platform. De codebase volgt Adobe's Magento Open Source. Op mage-os.org heet het "an upstream-compatible distribution built on top of Magento Open Source".

Concreet betekent dat:

• Dezelfde database-structuur en dezelfde API's als Magento Open Source.
• Dezelfde modules, themes en extensions werken in principe ook.
• Gratis, onder dezelfde open-source licenties (OSL 3.0 en AFL 3.0).
• Geen licentiekosten en geen contract met Adobe.

Wil je direct de vergelijking naast elkaar zien? Lees dan Mage-OS vs Magento Open Source. Dit artikel legt de basis uit.

Wie zit erachter?

De Mage-OS Association beheert het project. Dat is een non-profit, in 2022 officieel opgericht in Polen (Poznań). Community-leden begonnen in 2021 met organiseren.

Volgens mage-os.org:

• Het bestuur wordt jaarlijks gekozen door de leden, op de algemene ledenvergadering.
• Individuele leden die financieel bijdragen, krijgen stemrecht.
• Een Business Control Committee houdt onafhankelijk toezicht.
• De site noemt 214+ financiële bijdragers en 81+ professionele leden.
• Partners zijn onder meer Hyvä en ParadoxLabs (Silver), en bureaus als Vendic, Inchoo en integer_net (Bronze).

Hoe verhoudt Mage-OS zich tot Adobe?

Adobe is eigenaar van Magento Open Source en Adobe Commerce. Mage-OS staat daar los van. De Mage-OS-site noemt Adobe op de over-ons-pagina niet.

Er is ook een tweede organisatie: de Magento Association. Die is in 2018 met steun van Adobe opgericht en noemt zichzelf de steward van het Magento Open Source-project. Er zit een Adobe-medewerker in het bestuur. De Mage-OS Association en de Magento Association werken volgens Mage-OS samen aan initiatieven voor de community. Een formele band tussen Mage-OS en Adobe is er niet.

De eerlijke versie: Mage-OS is afhankelijk van Adobe's code. Mage-OS bouwt voort op wat Adobe in Magento Open Source publiceert. Stopt Adobe ooit met Open Source, dan moet Mage-OS de ontwikkeling zelf dragen. Precies dat scenario was de reden om te beginnen.

Waarom is Mage-OS ontstaan?

Na de overname van Magento door Adobe in 2018 groeide in de community de zorg over de toekomst van Open Source. Adobe stuurt op Adobe Commerce, het betaalde product. Open Source krijgt minder aandacht en volgt Adobe's planning.

De community wilde drie dingen:

• Continuïteit. Een platform dat blijft bestaan, ook als één bedrijf andere keuzes maakt.
• Tempo. Fixes en verbeteringen die niet wachten op een kwartaalplanning.
• Zeggenschap. Besluiten bij een vereniging met leden, niet bij een productroadmap.

De eerste stap was geen eigen product, maar een kopie van Adobe's Composer-repository. Hypernode bouwde in maart 2022 al een eigen Mage-OS-mirror voor zijn klanten. De eerste echte Mage-OS-distributie verscheen in november 2023.

Mirror en distributie: twee verschillende dingen

Mage-OS biedt twee Composer-repositories aan. Het verschil is belangrijk, want ze worden vaak door elkaar gehaald.

De mirror is een kopie van Adobe's packages. Je installeert gewoon Magento, alleen zonder de authenticatie van repo.magento.com. Je code blijft Magento Open Source.

De distributie is Mage-OS zelf. De packages heten mage-os/... en bevatten een Composer-replace voor de originele magento/...-naam. Een extension die magento/framework vereist, vindt dan het Mage-OS-package. Zo blijven bestaande extensions installeerbaar.

Wat doet de distributie anders?

Releases en versienummers

Mage-OS heeft eigen versienummers. Mage-OS 3.x is gebaseerd op Magento Open Source 2.4.9 (uitgebracht op 12 mei 2026). De 2.x-lijn volgde 2.4.8.

De 3.x-releases tot nu toe, volgens de GitHub-releases van mage-os/mageos-magento2:

Een vaste release-kalender publiceert Mage-OS niet. In de praktijk volgt er sinds de zomer elke maand een release, meestal kort na Adobe's maandelijkse security-patch. Daarnaast verschijnen extra releases als dat nodig is.

Security-patches als gewone Composer-update

Hier zit in 2026 het grootste praktische verschil. Adobe levert de maandelijkse security-fixes voor Open Source als zogenaamde "Isolated patch"-bestanden. Volgens Adobe's eigen kennisbank zijn dat ZIP-bestanden met patches, geen Composer-packages. Je moet ze in volgorde toepassen, en alle vorige maandpatches moeten erop staan. Open Source-shops kunnen die patches volgens Adobe alleen downloaden voor 2.4.7 en hoger.

Mage-OS neemt die patches over in een nieuwe release. Voor 3.6.0 portte het project Adobe's oktoberpatch (22 patchbestanden) naar de eigen broncode. Updaten is dan:

composer require mage-os/product-community-edition 3.6.0 --no-update
composer update

Dat scheelt handwerk en vergissingen in de volgorde. Maar het betekent ook dat je afhankelijk bent van het tempo van Mage-OS. Bij 3.6.0 zat er één dag tussen Adobe (13 oktober) en Mage-OS (14 oktober). Een garantie op die snelheid is er niet.

Extra modules

Mage-OS levert modules mee die Adobe in Open Source niet heeft. Voorbeelden uit de release notes: een RMA-module (retourbeheer) en een installer. In 3.0 zijn juist analytics-modules verwijderd. Mage-OS noemt op de site ook projecten rond PCI DSS 4.0 en AI-vertaling, die zijn begonnen in de Mage-OS Lab.

Elke extra module is ook extra code in je shop. Heb je al een retourmodule van een andere leverancier? Controleer dan of die niet botst.

Werkt het met extensions en Hyvä?

Mage-OS claimt "full database and API compatibility" met Magento Open Source. Technisch klopt dat grotendeels, dankzij de replace-constructie. Een extension die werkt op Magento 2.4.9, werkt in de regel ook op Mage-OS 3.x.

Twee kanttekeningen:

• Leverancierssupport. Niet elke leverancier ondersteunt Mage-OS officieel. Amasty zegt bijvoorbeeld dat Magento-extensions niet automatisch compatibel zijn, en test daarom zelf. Vraag het per extension na.
• Marketplace. Installeer je Mage-OS, dan heb je niet automatisch toegang tot de Adobe Commerce Marketplace. Betaalde Marketplace-extensions haal je via repo.magento.com. Die repository voeg je apart toe, bij voorkeur met een only-filter voor alleen die packages.

Hyvä is een frontend-theme bovenop de Magento-core. Mage-OS volgt diezelfde core, en Hyvä is Silver Partner van Mage-OS. Een officiële compatibiliteitsmatrix van Hyvä voor Mage-OS hebben we niet gevonden. Test daarom je Hyvä-theme, de checkout en je compat-modules altijd op staging.

Hoe stap je over vanaf Magento Open Source?

De overstap is vooral een Composer-wijziging. Mage-OS zegt zelf dat het 15 tot 30 minuten kost, zonder codewijzigingen. Dat gaat over het commando. Het testwerk eromheen kost meer tijd.

Op hoofdlijnen:

1. Zorg dat je op 2.4.9 staat. Mage-OS 3.x volgt 2.4.9. Draai je ouder, dan is eerst upgraden de echte klus. Zie Magento 2.4-versies en end-of-support.
2. Wijzig de repository. Voeg https://repo.mage-os.org/ toe als Composer-repository in plaats van repo.magento.com.
3. Vervang het metapackage. magento/product-community-edition wordt mage-os/product-community-edition.
4. Houd Marketplace-packages bereikbaar. Voeg repo.magento.com terug toe met een only-lijst voor betaalde extensions.
5. Run composer update en daarna je normale deploy: setup:upgrade, compilatie, static content.
6. Vergelijk met een schone installatie. Maak een verse Mage-OS-project aan en vergelijk de composer.json regel voor regel. Dat voorkomt rare dependency-fouten.

Risico's en testen

Wat je in de praktijk test:

• Checkout en alle betaalmethodes, inclusief refunds.
• Koppelingen met ERP, PIM, voorraad en verzending.
• Cron, queues en indexers.
• Elke extension, vooral betaalde uit de Marketplace.
• Botsingen tussen Mage-OS-modules en wat je al hebt.

Plan altijd een rollback. Volgens Mage-OS is terug naar Magento Open Source mogelijk. Test die weg vooraf, zodat je hem niet voor het eerst gebruikt op een zaterdagavond.

Draai je nog Magento 1 of een sterk verouderde 2.x? Dan hoort dit bij een bredere Magento migratie, niet bij een distributiewissel.

Voor wie is Mage-OS zinvol?

Blijven op Magento Open Source is geen slechte keuze. Het is dezelfde kern, met Adobe als bron. Je accepteert wel Adobe's patchvorm en Adobe's tempo.

Adobe Commerce is een ander gesprek. Daar betaal je voor features zoals B2B, voor Adobe-support en voor de cloud-omgeving. Mage-OS vervangt dat niet. Die afweging is vooral een rekensom: licentiekosten tegenover de features die je echt gebruikt.

Wat betekent het voor support en security?

Er is geen SLA. Niet van Adobe en niet van de Mage-OS Association. Support komt van de community (onder meer via chat.mage-os.org) en van je eigen partner.

Voor security geldt:

• Mage-OS neemt Adobe's security-patches over in eigen releases. In 2026 gebeurde dat binnen dagen.
• Mage-OS beëindigt bij een nieuwe release vaak de ondersteuning van de vorige. 3.6.0 maakte 3.5.0 end-of-life. Bijblijven is dus geen optie maar een vereiste.
• Patchen alleen is niet altijd genoeg. Bij 3.5.0 adviseerde Mage-OS ook een compromise-check en het roteren van credentials. Adobe gaf voor CVE-2026-75650 hetzelfde advies.

De distributiekeuze lost een slecht patchproces niet op. Een shop die weken achterloopt is kwetsbaar, op Mage-OS en op Magento Open Source. Wat je nodig hebt: monitoring, een staging-omgeving en iemand die binnen een dag kan patchen.

Wil je weten of Mage-OS past bij jouw shop, of hoe je Magento verder onderhoudt? Neem contact op. Ons team kijkt mee naar je huidige versie, extensions en patchstatus.