Magento-Installation: Magento 2.4.9 Schritt für Schritt installieren

Diese Anleitung führt Schritt für Schritt durch eine Magento-Installation der Version 2.4.9 auf einem Linux-Server. Alle Anforderungen und Befehle stammen aus der offiziellen Installationsanleitung von Adobe auf Experience League. Wenn Sie sich schon gefragt haben “Magento – wie installiere ich es richtig?”: Das ist die Reihenfolge, die wir auf Kundenservern einhalten.

Vorausgesetzt werden SSH-Zugang, Root- oder Sudo-Rechte und eine Domain, die auf den Server zeigt. Für eine lokale Testinstallation funktionieren dieselben Schritte in einem Container oder einer VM.

Anforderungen für die Magento-Installation 2.4.9

Magento Open Source und Adobe Commerce 2.4.9 wurden am 12. Mai 2026 veröffentlicht. Adobe unterstützt nur genau die Kombinationen von Diensten, die getestet wurden. Für 2.4.9 On-Premises nennt die Tabelle der Systemanforderungen:

Adobe weist darauf hin, dass das Support-Team Sie bitten kann, auf eine gelistete Kombination umzustellen, bevor Probleme untersucht werden. Bleiben Sie für einen produktiven Shop innerhalb dieser Tabelle.

PHP-Extensions und -Einstellungen

Magento Open Source benötigt diese PHP-Extensions: bcmath, ctype, curl, dom, fileinfo, filter, ftp, gd, hash, iconv, intl, json, libxml, mbstring, openssl, pcre, pdo_mysql, reflection, simplexml, soap, sockets, sodium, tokenizer, xmlwriter, xsl, zip und zlib. Prüfen Sie Ihre Installation mit:

php -v
php -m

Setzen Sie in php.iniden Wert date.timezone, erhöhen Sie memory_limit (das Beispiel von Adobe verwendet 2G) und setzen Sie den Realpath-Cache:

memory_limit = 2G
realpath_cache_size = 10M
realpath_cache_ttl = 7200

Schritt 1: Datenbank und OpenSearch vorbereiten

Legen Sie eine leere Datenbank und einen eigenen Benutzer an:

mysql -u root -p
CREATE DATABASE magento;
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'a-strong-password';
GRANT ALL ON magento.* TO 'magento'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Seit Magento 2.4 muss jede Installation Elasticsearch oder OpenSearch für die Katalogsuche nutzen, und die Suchmaschine muss vor der Installation laufen. Für 2.4.9 bedeutet das OpenSearch 3. Prüfen Sie, ob es antwortet, bevor Sie weitermachen:

curl -X GET "http://localhost:9200/"

Läuft OpenSearch auf einem anderen Host, empfiehlt Adobe, es hinter einen TLS-Reverse-Proxy mit HTTP-Basic-Authentifizierung zu stellen, statt Port 9200 offenzulegen.

Schritt 2: Zugangsschlüssel besorgen

Magento wird aus dem Composer-Repository von Adobe unter repo.magento.com installiert. Sie brauchen ein Paar Zugangsschlüssel:

1. Melden Sie sich im Commerce Marketplace an.
2. Öffnen Sie My Profile > Access Keys und erstellen Sie ein neues Schlüsselpaar.
3. Wenn Composer nach einem Benutzernamen fragt, verwenden Sie den Public Key. Als Passwort verwenden Sie den Private Key.

Wenn Sie die Schlüssel in der Composer-Datei auth.jsonspeichern, werden Sie nicht danach gefragt.

Schritt 3: Magento 2.4.9 mit Composer herunterladen

Wechseln Sie zum Eigentümer des Dateisystems (dem Benutzer, dem das Web-Root gehört, nicht root), gehen Sie in Ihr Web-Root und legen Sie das Projekt an. So installieren Sie Magento 2 Open Source in einer bestimmten Version:

cd /var/www
composer create-project --repository-url=https://repo.magento.com/ \
  magento/project-community-edition=2.4.9 magento2

Für Adobe Commerce verwenden Sie stattdessen magento/project-enterprise-edition . Wenn Fehler wie “Could not find package” erscheinen, prüfen Sie den Befehl auf Tippfehler und ob Ihre Schlüssel Zugriff auf diese Edition haben.

Schritt 4: Dateiberechtigungen setzen

Die Gruppe des Webservers braucht vor der Installation Schreibzugriff auf einige Verzeichnisse. Die Quick-Start-Anleitung von Adobe verwendet diese Befehle (Ubuntu-Beispiel mit www-data):

cd /var/www/magento2
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data .
chmod u+x bin/magento

Verwenden Sie nicht chmod 777. Das ist eine beliebte Abkürzung in Tutorials und auf einem Live-Server ein echtes Sicherheitsrisiko.

Schritt 5: setup:install ausführen

Das ist der Kern der Installation von Magento 2.4.9. Führen Sie den Befehl im Magento-Stammverzeichnis aus:

bin/magento setup:install \
  --base-url=https://www.example.com/ \
  --db-host=localhost \
  --db-name=magento \
  --db-user=magento \
  --db-password='a-strong-password' \
  --admin-firstname=Jane \
  --admin-lastname=Doe \
  [email protected] \
  --admin-user=jane.admin \
  --admin-password='Use-a-long-passphrase-1' \
  --language=en_US \
  --currency=USD \
  --timezone=America/Chicago \
  --use-rewrites=1 \
  --search-engine=opensearch \
  --opensearch-host=localhost \
  --opensearch-port=9200 \
  --opensearch-index-prefix=magento2 \
  --opensearch-timeout=15

Einige Optionen, die Sie verstehen sollten:

• –base-url braucht das Schema und einen abschließenden Schrägstrich.
• –admin-password muss mindestens 7 Zeichen mit Buchstaben und Zahlen haben. Verwenden Sie ein deutlich längeres Passwort und setzen Sie es in einfache Anführungszeichen.
• –backend-frontname legt den Admin-Pfad fest. Adobe empfiehlt, die Option wegzulassen, damit das Installationsprogramm einen zufälligen Pfad erzeugt. Die Admin-URL wird am Ende ausgegeben, und Sie können sie später anzeigen mit bin/magento info:adminuri.
• –use-secure=1, –base-url-secure und –use-secure-admin=1 aktivieren HTTPS für Storefront und Admin. Alle drei sind erforderlich.
• bin/magento info:language:list, info:currency:list und info:timezone:list zeigen gültige Werte an.

Das Installationsprogramm kann erneut ausgeführt werden, um Fehler zu korrigieren oder SSL-Einstellungen später zu ergänzen. Die vollständige Liste der Optionen erhalten Sie mit bin/magento help setup:install.

Schritt 6: Cron einrichten

Magento ist für Indexierung, E-Mails, Sitemaps, Währungskurse und mehr auf Cron angewiesen. Installieren Sie die Magento-Crontab als Eigentümer des Dateisystems:

bin/magento cron:install
crontab -l

Der Befehl schreibt seine Einträge zwischen die Markierungen #~ MAGENTO START und #~ MAGENTO END und lässt Ihre anderen Cronjobs unberührt. Verwenden Sie --force , um einen bestehenden Magento-Block neu zu schreiben.

Schritt 7: In den Production Mode wechseln

Eine frische Installation läuft im Default Mode. Wechseln Sie für einen Live-Shop in den Production Mode, der den Code kompiliert und die statischen Dateien deployt:

bin/magento deploy:mode:set production
bin/magento deploy:mode:show

Verwenden Sie den developer -Modus in lokalen und Staging-Umgebungen, in denen Sie aktiv Code ändern.

Schritt 8: Checkliste nach der Magento-Installation

• Richten Sie Ihren nginx-Virtual-Host auf pub/ als Document Root aus und verwenden Sie dazu die Beispieldatei nginx.conf.sample , die mit Magento ausgeliefert wird.
• Konfigurieren Sie Valkey für Cache und Sessions sowie Varnish als Full-Page-Cache.
• Richten Sie den E-Mail-Versand ein, damit die Zwei-Faktor-Authentifizierung im Admin und die Kunden-E-Mails funktionieren.
• Führen Sie bin/magento indexer:reindex und bin/magento cache:flushaus und rufen Sie dann Storefront und Admin auf.
• Richten Sie Backups und Monitoring ein, bevor Sie Produkte importieren.

Lieber zuschauen? Unsere kostenlosen Magento-Video-Tutorials behandeln Installation und Einrichtung. Wenn Sie PHP 8.5, OpenSearch, Valkey und Varnish nicht selbst verwalten möchten, bietet Ihnen unser Managed Magento Hosting eine fertige, optimierte 2.4.9-Umgebung.

Häufige Fehler bei der Magento-Installation

• Could not find package. Meist ein Tippfehler im Paketnamen oder in der Version, oder Zugangsschlüssel ohne Berechtigung für diese Edition. Prüfen Sie den Befehl und Ihre Schlüssel im Commerce Marketplace.
• Verbindungsfehler zur Suchmaschine bei setup:install. OpenSearch läuft nicht, oder Host, Port oder Zugangsdaten sind falsch. Testen Sie es mit curl vom Webserver aus, bevor Sie das Installationsprogramm erneut ausführen.
• Permission denied bei var, generated oder pub/static. Die Befehle wurden als root ausgeführt, oder die Dateien gehören nicht der Webserver-Gruppe. Setzen Sie die Berechtigungen aus Schritt 4 als Eigentümer des Dateisystems erneut.
• Fehlende PHP-Extension. Composer oder das Installationsprogramm nennt die fehlende Extension. Installieren Sie sie mit Ihrem Paketmanager, starten Sie PHP-FPM neu und prüfen Sie mit php -m.

Da das Installationsprogramm mehrfach ausgeführt werden kann, können Sie die Ursache beheben und setup:install erneut ausführen. Standardmäßig wird eine bestehende Datenbank nicht überschrieben; die Option --cleanup-database ändert das.

Häufig gestellte Fragen

Kann ich Magento 2.4.9 auf Shared Hosting installieren?

In der Regel nicht. Sie brauchen SSH, Composer, PHP 8.5 mit bestimmten Extensions und einen laufenden OpenSearch-Dienst. Die meisten Shared-Hosting-Tarife bieten diese Kombination nicht.

Wird Elasticsearch noch unterstützt?

Laut Suchmaschinen-Leitfaden von Adobe müssen Installationen Elasticsearch oder OpenSearch verwenden, doch die Anforderungstabelle für 2.4.9 nennt nur OpenSearch 3. Verwenden Sie für neue 2.4.9-Installationen OpenSearch.

Kann ich Apache statt nginx verwenden?

Die Anforderungstabelle für 2.4.9 nennt nginx 1.30, Apache dagegen nicht. Apache funktioniert unter Umständen trotzdem, aber nginx ist die getestete und unterstützte Option.

Was ist der Unterschied zwischen der Installation von Open Source und Adobe Commerce?

Die Schritte sind dieselben. Der Unterschied liegt im Metapaket (project-community-edition oder project-enterprise-edition) und darin, ob Ihre Zugangsschlüssel für Adobe Commerce lizenziert sind.

Quellen

• Adobe: Systemanforderungen
• Adobe: Quick-Start-Installation On-Premises
• Adobe: Erweiterte Installation On-Premises
• Adobe: PHP-Einstellungen
• Adobe: Voraussetzungen für die Suchmaschine
• Adobe: Cron konfigurieren und ausführen
• Adobe: Anwendungsmodus festlegen
• Adobe: Release Notes zu Magento Open Source 2.4.9