Your Journey to Open-Source Commerce Starts Here
Whether you're launching a new store, migrating from Magento Open Source, or setting up a development environment—we have a clear path to get you running quickly.
How Would You Like to Start?
Select the guide that best matches your situation. Each path is designed to get you to a working Mage-OS installation as quickly as possible.
Quick Start Preview
Here's what you'll accomplish in our Quick Start guide
Step 1: Install via Composer
One command gets you started: composer create-project --repository-url=https://repo.mage-os.org/ mage-os/project-community-edition .
Step 2: Configure Your Store
Run the setup wizard to connect your database, create an admin account, and configure basic store settings like currency and locale.
Step 3: Build & Deploy
Compile dependency injection, deploy static assets, and clear the cache. These commands prepare your store for visitors.
Your Store is Live!
Access your new storefront and admin panel. From here, explore product setup, payment configuration, and shipping options.
Migrating from Magento? It's Easier Than You Think
Keep What Works, Gain What's Better
Many stores have successfully migrated from Magento Open Source to Mage-OS without disruption.Full Extension Compatibility
Your existing Magento 2 extensions, themes, and customizations work seamlessly with Mage-OS.
Simple Composer Update
Migration is typically just a repository swap in composer.json followed by a composer update.
Rollback Ready
Our guide includes complete rollback procedures so you can migrate with confidence.
What You'll Need
Most modern hosting environments meet these requirements. Check our detailed system requirements page for compatibility notes.
With required extensions (intl, soap, gd, etc.)
For product, customer, and order data
Manages PHP dependencies and updates
Powers catalog and site search
Handles cache and session storage
Serves your storefront to visitors
Deployment Options
Mage-OS runs anywhere Magento does. Here are the most common deployment scenarios.
Local Development
Use Docker with DDEV, Warden, or docker-magento for a consistent, isolated development environment. Perfect for building extensions, testing upgrades, or local debugging.
Cloud Hosting
Deploy to AWS, Google Cloud, Azure, or specialized Magento hosts. Scalable and managed options available.
Dedicated Servers
Full control with VPS or bare metal. Ideal for agencies managing multiple stores or businesses with specific compliance requirements.
Enterprise Infrastructure
Multi-server setups with load balancers, separate database clusters, Redis clusters, and CDN integration for maximum performance and reliability.
Developer Resources
Quick access to official Mage-OS resources, documentation, and development tools.
Source code, issues, and contributions
Guides, API references, and tutorials
Q&A from the developer community
Experimental projects and prototypes
Curated list of extensions and tools
Community resource collection
Community & Support Channels
Connect with the Mage-OS community and get help from experienced developers.
Learning & Training Resources
From Beginner to Expert
Invest in your skills with training resources from trusted community educators. These courses cover everything from Magento fundamentals to advanced development techniques.M.academy
Comprehensive Magento development courses from beginner to advanced. The Coding Kickstart is ideal for new developers.
Yireo Training
In-depth Magento 2 training covering frontend development, backend development, and performance optimization.
SwiftOtter
Developer training programs and certification preparation for Magento 2 professionals.
MageMastery
Video courses and workshops covering Magento 2 development fundamentals and advanced topics.
Stay Informed
Keep up with the latest Mage-OS and Magento ecosystem news through these community channels.
Official updates on releases, features, and community news delivered to your inbox.
Discussions about Magento development, ecommerce trends, and community updates.
Curated news, tutorials, and updates from the Magento ecosystem.
Common Questions
Do I need to be a developer to install Mage-OS?
Basic command-line knowledge is helpful, but our Quick Start guide walks you through each step.
Can I migrate from Adobe Commerce?
Mage-OS is based on Magento Open Source. If you are using Adobe Commerce-specific features, some additional planning may be required. Contact one of our partners for guidance on your specific situation.
What support is available during setup?
Our Discord community has active channels for installation help. You can also find partner agencies offering professional installation and migration services.
How long does migration from Magento take?
A straightforward migration can take under 30 minutes. Complex stores with many customizations should plan additional time for testing.
Ready to Begin Your Mage-OS Journey?
Choose your path: new installations start with our Quick Start guide, while existing Magento stores should check out the Migration Guide. Either way, you'll be running Mage-OS in no time.
