TL;DR
Mage-OS ist eine kostenlose, von der Community betriebene Drop-in-Alternative zu Magento Open Source. Um es zu installieren, laden Sie das Projekt mit Composer herunter, führen das Installationsprogramm aus, um Ihre Datenbank und Suchmaschine zu verbinden, kompilieren und stellen dann Ihre Storefront bereit. Wenn Sie bereits Magento 2.4.8 oder höher verwenden, können Sie mit dem offiziellen Migrationsskript umsteigen, anstatt neu zu beginnen. Der gesamte Vorgang dauert für die meisten Entwickler weniger als eine Stunde, sobald der Server die unten aufgeführten Anforderungen erfüllt.
Einführung
MageOS ist zur ersten Wahl für Händler geworden, die die Flexibilität von Magento ohne die Lizenzlast von Adobe wünschen. Es ist Open Source, abwärtskompatibel und wird von einer Community aus Agenturen und Entwicklern gepflegt, die Sicherheitspatches innerhalb weniger Tage nach der Veröffentlichung von Adobes Patch Tuesday veröffentlichen.
Dieser Leitfaden führt Sie Schritt für Schritt durch MageOS Installation, von der Überprüfung Ihrer Serveranforderungen bis zur Ausführung Ihrer ersten Storefront-Seite. Unabhängig davon, ob Sie einen neuen Shop eröffnen oder eine bestehende Magento 2 Site migrieren, finden Sie unten genau die Befehle, die Sie benötigen.
Lesen Sie auch unseren neuesten veröffentlichten Artikel über:
- Was ist MageOS? Der vollständige Leitfaden zur Community-gesteuerten Open-Source-Commerce-Plattform
- Die 10 besten Magento Webentwicklungs-Agenturen im Jahr 2026
- Top 5 der besten Magento Entwicklungsagenturen in den USA (2026)
Was ist MageOS?
Mage-OS ist eine offene Initiative, um die Zugänglichkeit, Langlebigkeit und den Erfolg der Magento®-Plattform und des Magento®-Ökosystems sicherzustellen. Es beinhaltet ein E-Commerce-Produkt.
MageOS (oder Mage-OS) ist eine unabhängige, von der Community betriebene Distribution von Magento Open Source. Es wurde als Fork erstellt und wird von der gemeinnützigen Mage-OS Association verwaltet und verwaltet, um schnellere Sicherheitsupdates bereitzustellen, den technischen Stack zu modernisieren und Abhängigkeiten von Adobe-Anmeldeinformationen zu beseitigen.
Mit anderen Worten: MageOS ist eine Open-Source-E-Commerce-Plattform, die als Ableger des Magento Kerns aufgebaut ist. Es handelt sich um eine unabhängige, gemeinnützige Distribution, die nicht mit Adobe oder Magento verbunden ist. Der Code bleibt vollständig kompatibel mit dem breiteren Magento Ökosystem, was bedeutet, dass bestehende Themes, Erweiterungen und Integrationen weiterhin funktionieren.
Systemanforderungen
Vor dir Installieren Sie MageOS, bestätigen Sie, dass Ihr Server diese Mindestanforderungen erfüllt. Die neueste Mage-OS Version unterstützt auch neuere PHP-Versionen für eine bessere Leistung.
| Erfordernis | Minimum | Empfohlen |
|---|---|---|
| PHP | 8.3 | 8.5 |
| Komponist | 2.7+ | 2.9.3+ |
| Datenbank | MySQL 8.0+ oder MariaDB 10.6+ | MySQL 8.4 oder MariaDB 11.4 |
| Suchmaschine | OpenSearch 2+ | OpenSearch 2.19 |
| Betriebssystem | Linux | Linux (Produktion erforderlich; macOS und Windows über WSL2 nur für lokale Entwicklung) |
Wussten Sie?
Mage-OS ist eine zu 100 % gemeinschaftseigene Open-Source-E-Commerce-Plattform. Es handelt sich um eine direkte Weiterentwicklung und Upstream-kompatible Alternative zu Magento Open Source.
Bevor Sie beginnen, sollten Sie sich einige Hinweise merken:
- Produktionsbereitstellungen erfordern Linux. macOS und Windows eignen sich nur für die lokale Entwicklung, typischerweise über WSL2 oder Docker-basierte Tools wie DDEV oder Warden.
- Elasticsearch wird im gesamten Magento Ökosystem auslaufen. OpenSearch ist die empfohlene Suchmaschine für neue Mage-OS Installationen.
- Überprüfen Sie immer Ihre PHP-Erweiterungen vor der Installation. Fehlende Erweiterungen sind eine der häufigsten Ursachen für fehlgeschlagene Installationen.
Schritt 1: Laden Sie das Mage-OS Projekt herunter
Öffnen Sie Ihr Terminal und navigieren Sie zu Ihrem Projektverzeichnis. Führen Sie diesen Composer-Befehl aus, um die Community Edition herunterzuladen:
composer create-project --repository-url=https://repo.mage-os.org/ mage-os/project-community-edition
Dadurch wird die neueste stabile MageOS Version zusammen mit allen erforderlichen Abhängigkeiten abgerufen. Abhängig von Ihrer Verbindungsgeschwindigkeit dauert dieser Schritt normalerweise einige Minuten.
Schritt 2: Führen Sie das MageOS Installationsprogramm aus
Sobald Composer fertig ist, führen Sie den Setup-Befehl aus, um Ihre Datenbank zu verbinden, Ihre Suchmaschine zu konfigurieren und Ihr Administratorkonto zu erstellen.
bin/magento install \
--base-url=http://yourdomain.com \
--db-host=localhost \
--db-name=mageos_db \
--db-user=db_user \
--db-password=db_password \
--admin-firstname=Admin \
--admin-lastname=User \
--admin-email=admin@example.com \
--admin-user=admin \
--admin-password=SecurePassword123 \
--search-engine=opensearch \
--opensearch-host=localhost \
--opensearch-port=9200
Bevorzugen Sie eine geführte Einrichtung, anstatt jedes Flag manuell zu übergeben? Führen Sie bin/magento install alleine aus, um den interaktiven Befehlszeilenassistenten zu starten.
Hier ein paar praktische Tipps:
- Verwenden Sie ein sicheres, eindeutiges Administratorkennwort. Schwache Zugangsdaten sind nach wie vor eine der Hauptursachen für die Kompromittierung von Geschäften.
- Überprüfen Sie Ihren Basis-URL-Wert noch einmal. Eine falsche Basis-URL führt dazu, dass das Laden und Auschecken von Assets nach Abschluss der Installation unterbrochen wird.
- Wenn das Installationsprogramm fehlschlägt, deutet die Fehlermeldung fast immer auf eine fehlende PHP-Erweiterung oder ein Datenbankverbindungsproblem hin. Überprüfen Sie beides, bevor Sie es erneut versuchen.
Schritt 3: Kompilieren und Bereitstellen
Erstellen Sie nach Abschluss der Installation die Abhängigkeitsinjektion und stellen Sie Ihre statischen Dateien bereit, damit die Storefront korrekt gerendert wird.
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
Führen Sie diese Befehle der Reihe nach aus. Das Überspringen von setup:di:compile ist einer der häufigsten Gründe, warum Entwickler nach einer Neuinstallation eine leere oder defekte Storefront sehen.
Migrieren Sie Ihr Luma-basiertes Theme zum Hyva-Theme mit 100 % SEO-Migration!
Migrieren Sie Ihr Luma-Theme zu Hyvä unter vollständiger Beibehaltung von Design und Funktionalität für schnellere Leistung und ein besseres Benutzererlebnis.
Migration von einem vorhandenen Magento 2 Shop
Wenn Sie bereits Magento 2.4.8 oder höher verwenden, müssen Sie nicht von vorne beginnen. Mage-OS ist als Ersatz konzipiert und die Community unterhält ein offizielles Migrationsskript, das den Wechsel für Sie übernimmt.
bash <(curl -s https://raw.githubusercontent.com/mage-os-lab/migrate-m2-to-mageos/refs/heads/main/migrate-to-mage-os.sh)
Führen Sie dies nur im Entwicklermodus aus, zuerst in einer lokalen oder Staging-Umgebung. Sobald Sie bestätigt haben, dass die Migration sauber verläuft, wiederholen Sie den Vorgang in der Produktion während eines geplanten Wartungsfensters.
Die vier häufigsten Probleme und Korrekturen bei der MageOS Installation
- Das Installationsprogramm wird wegen fehlender Erweiterungsfehler angehalten
Überprüfen Sie Ihre installierten PHP-Erweiterungen mit php -m und vergleichen Sie sie mit der erforderlichen Liste. Installieren Sie alle fehlenden Erweiterungen über den Paketmanager Ihres Servers und führen Sie dann das Installationsprogramm erneut aus. - Der Suchkatalog gibt nach der Installation keine Ergebnisse zurück
Dies bedeutet normalerweise, dass OpenSearch nicht ausgeführt wird oder die Host- und Portwerte in Ihrem Installationsbefehl nicht mit Ihrer OpenSearch-Konfiguration übereinstimmen. Vergewissern Sie sich vor der Neuinstallation, dass der Dienst aktiv ist. - Ladenfront mit kaputtem Design
Dies deutet auf einen übersprungenen oder fehlgeschlagenen Schritt „setup:static-content:deploy“ hin. Führen Sie den Befehl mit dem Flag -f erneut aus, um eine saubere Bereitstellung zu erzwingen. - Der Composer-Download schlägt fehl oder es kommt zu einer Zeitüberschreitung
Stellen Sie sicher, dass Ihr Server über eine stabile ausgehende Verbindung verfügt und dass Composer mindestens auf Version 2.7 aktualisiert ist. Führen Sie das Composer-Selbstupdate aus, wenn Sie sich über Ihre aktuelle Version nicht sicher sind.
Warum sollten Sie für Ihr Mage-OS Projekt mit iCreative-Technologien arbeiten?
iCreative Technologies gehörte zu den ersten Agenturen, die MageOS für Kundenprojekte einführten, wodurch unser Team praktische Erfahrungen mit der Plattform sammeln konnte, weit vor dem breiteren Markt. Wir sind auch ein zertifizierter Hyvä Theme Technical Bronze PartnerDas bedeutet, dass jede von uns erstellte MageOS Storefront schnell und leichtgewichtig ist und auf einer Themenarchitektur basiert, die auf langfristige Leistung ausgelegt ist.
Als Führend Agentur für Magento Webentwicklungsdienste in den USA Und als globaler digitaler Partner, der E-Commerce-Marken in über 12 Ländern bedient, legen wir bei jedem Auftrag den gleichen Standard fest, egal ob ein Kunde einen bestehenden Magento Shop auf Mage-OS migriert oder einen neuen einführt.
Unser Team hat geliefert Über 2.000 Projekte über Magento, Mage-OS, Shopware, Shopify Plus und PrestaShop, unterstützt von CMMI Level 3 und ISO 9001 Zertifizierungen.
Wenn Sie MageOS für Ihren Shop evaluieren oder eine Migration von Magento planen, kann unser Team Ihnen beim Umfang des Projekts helfen, die technische Migration abwickeln und eine Hyvä basierte Storefront aufbauen, die auf Geschwindigkeit und Konvertierung ausgelegt ist.
Laden Sie MageOS in wenigen Minuten herunter!
Sind Sie bereit, Ihr nächstes Projekt zu starten? Laden Sie die neueste Version von Mage-OS von der offiziellen Mage-OS Downloadseite unten herunter.
Häufig gestellte Fragen zur MageOS Installation
Ja. Mage-OS ist vollständig Open Source und kostenlos, im Gegensatz zu Magento Commerce oder Adobe Commerce fallen keine Lizenzgebühren an.
Ja. Das offizielle Migrationsskript wurde speziell für die Umstellung eines bestehenden Magento 2.4.8+ Stores auf Mage-OS entwickelt, während Ihre Daten, Erweiterungen und Ihr Theme intakt bleiben.
Ja. Mage-OS behält die Abwärtskompatibilität mit Magento Erweiterungen und -Themen bei, einschließlich Hyvä.
Für einen Entwickler, der mit Magento vertraut ist, dauert eine Neuinstallation normalerweise 30 bis 60 Minuten, die Serverbereitstellung nicht eingerechnet.
Es ist Mage OS völlig kostenlos und Open Source
Eine globale Community aus Entwicklern, Agenturen und Händlern
Tragen Sie zu Mage OS bei, das von der gemeinnützigen Mage OS Association betreut wird.
Mage OS ist so konzipiert, dass es mit dem kompatibel bleibt
ein breiteres Magento Ökosystem, und viele Geschäfte, die Hyvä auf Magento 2 betreiben, können es darauf ausführen
Mage OS ebenfalls, es lohnt sich jedoch, die Kompatibilität für Ihr spezifisches Setup zu bestätigen.
