Auf dieser Seite: [ausblenden]
Magento ist eine der leistungsstärksten verfügbaren E-Commerce-Plattformen. Aber es installieren? Da bleiben die meisten Menschen stecken. Im Gegensatz zu einfacheren Plattformen, Magento benötigt spezielle Serverkonfigurationen, Suchmaschinen, und sorgfältige Einrichtung. Überspringen Sie einen Schritt, und Sie werden Stunden damit verbringen, Fehler zu beheben.
Dieser Leitfaden führt Sie durch das gesamte Magento 2 Installationsprozess. Sie erfahren, was Ihr Server benötigt, Anleitung zur Installation mit Composer (die empfohlene Methode), und wie man alles richtig konfiguriert. Egal, ob Sie eine Entwicklungsumgebung oder einen Produktionsspeicher einrichten, Es gelten diese Schritte.
Eine kurze Anmerkung zu den Versionen: Magento Open Source 2.4.8 ist die aktuelle Version. Adobe hat Magento Commerce in Adobe Commerce umbenannt, aber die Open-Source-Version bleibt kostenlos. Dieser Leitfaden deckt beides ab, obwohl der Installationsprozess nahezu identisch ist.
Zuletzt aktualisiert: Februar 2026. Alle Anforderungen und Befehle anhand der aktuellen Dokumentation überprüft.
Magento-Systemanforderungen
Magento ist ressourcenhungrig. Es läuft nicht auf billigem Shared Hosting. Bevor du anfängst, Stellen Sie sicher, dass Ihr Server diese Anforderungen erfüllt.
Betriebssystem
Magento erfordert Linux x86-64. Ubuntu 22.04 oder 24.04 LTS, RHEL, CentOS, und Debian funktionieren alle. Windows und macOS werden für die Produktion nicht unterstützt. Sie können macOS für die lokale Entwicklung verwenden, aber nicht darauf bereitstellen.
Webserver
Sie benötigen entweder Apache 2.4 oder Nginx 1.18 (oder später). Für Apache muss mod_rewrite aktiviert sein. Nginx wird oft wegen der Leistung bevorzugt, aber beide funktionieren gut. Wählen Sie basierend auf Ihrer Vertrautheit.
PHP-Anforderungen
Magento 2.4.7 und 2.4.8 erfordern PHP 8.1 oder 8.2. Frühere Versionen funktionieren nicht. Außerdem müssen bestimmte PHP-Erweiterungen installiert sein:
- ext-bcmath
- ext-ctype
- ext-curl
- ext-dom
- ext-gd
- ext-intl
- ext-mbstring
- ext-openssl
- ext-pdo_mysql
- ext-seife
- ext-xsl
- ext-zip
- Ext-Buchsen
Auch die PHP-Konfiguration ist wichtig. Satz memory_limit auf mindestens 2GB. Zunahme max_execution_time zu 18000 zum Einbau. OPcache aktivieren (ein PHP-Leistungsverstärker) für eine schnellere Ausführung.
Datenbank
Magento 2.4.7 und später erfordern MySQL 8.0 oder MariaDB 10.4 (oder höher). Frühere MySQL-Versionen funktionieren nicht. Die Datenbank benötigt Unterstützung für die InnoDB-Speicher-Engine und die richtige UTF-8-Kodierung.
Suchmaschine (Erforderlich)
Das ist es, was viele Menschen aus der Fassung bringt: Magento 2.4+ erfordert eine Suchmaschine. MySQL führt keine Katalogsuche mehr durch. Sie müssen beides installieren:
- Elasticsearch 7.17 oder 8.x
- OpenSearch 1.2 oder 2.x (ein Fork von Elasticsearch, voll kompatibel)
OpenSearch wird für Neuinstallationen empfohlen. Es ist Open Source und wird regelmäßig aktualisiert. Auf die Installation gehen wir später ein.
Zusätzliche Anforderungen
- Komponist 2.2+ – PHP-Abhängigkeitsmanager (für die Installation erforderlich)
- RAM – Mindestens 2 GB, 4GB empfohlen
- Lager – Mindestens 10 GB SSD (NVMe bevorzugt)
- SSL-Zertifikat – Erforderlich für HTTPS (Selbstsigniert wird nicht funktionieren)
- TLS 1.2 – Erforderlich für den PayPal- und Magento-Repository-Zugriff
Empfohlenes Hosting
Shared Hosting funktioniert nicht für Magento. Du brauchst ein VPS oder dedizierter Server mit vollem Root-Zugriff. Rechnen Sie damit, mindestens 20–50 US-Dollar/Monat für angemessene Ressourcen auszugeben. Für stark frequentierte Geschäfte, dedizierte Server oder Cloud-Hosting sorgen für eine bessere Skalierbarkeit.
Vorinstallation: Servervorbereitung
Vor der Installation von Magento, Ihr Server benötigt eine ordnungsgemäße Konfiguration. Diese Schritte setzen Ubuntu voraus 22.04, Für andere Distributionen sind die Befehle jedoch ähnlich.
Schritt 1: Aktualisieren Sie Ihr System
Beginnen Sie mit einem neuen Systemupdate:
sudo apt update && sudo apt upgrade -y
Schritt 2: Installieren Sie PHP und erforderliche Erweiterungen
Fügen Sie das PHP-Repository hinzu und installieren Sie PHP 8.2 mit allen erforderlichen Erweiterungen:
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install php8.2 php8.2-fpm php8.2-mysql php8.2-xml php8.2-curl php8.2-gd php8.2-intl php8.2-mbstring php8.2-soap php8.2-xsl php8.2-zip php8.2-bcmath php8.2-sockets -y
Schritt 3: Konfigurieren Sie PHP-Einstellungen
Bearbeiten Sie Ihre PHP-Konfigurationsdatei:
sudo nano /etc/php/8.2/fpm/php.ini
Suchen und ändern Sie diese Werte:
memory_limit = 2G
max_execution_time = 18000
zlib.output_compression = On
Starten Sie PHP-FPM neu (PHP FastCGI-Prozessmanager) Änderungen anzuwenden:
sudo systemctl restart php8.2-fpm
Schritt 4: Installieren Sie MySQL 8.0
sudo apt install mysql-server -y
sudo mysql_secure_installation
Erstellen Sie eine Datenbank und einen Benutzer für Magento:
sudo mysql -u root -p
CREATE DATABASE magento2;
CREATE USER 'magento_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON magento2.* TO 'magento_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Schritt 5: Installieren Sie Nginx
sudo apt install nginx -y
sudo systemctl enable nginx
Schritt 6: Installieren Sie Composer
Composer verwaltet die Abhängigkeiten von Magento. Installieren Sie es global:
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version
Verifizieren Sie den Komponisten 2.2+ ist installiert. Ältere Versionen verursachen Abhängigkeitsprobleme.
Schritt 7: Installieren Sie OpenSearch
OpenSearch erfordert Java. Installieren Sie zuerst OpenJDK:
sudo apt install openjdk-11-jdk -y
Fügen Sie das OpenSearch-Repository hinzu und installieren Sie es:
curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | sudo apt-key add -
echo "deb https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-2.x.list
sudo apt update
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=YourSecurePassword123! apt install opensearch -y
Konfigurieren Sie OpenSearch durch Bearbeiten /etc/opensearch/opensearch.yml:
cluster.name: magento2
network.host: localhost
http.port: 9200
discovery.type: single-node
plugins.security.disabled: true
Starten und aktivieren Sie den Dienst:
sudo systemctl enable opensearch
sudo systemctl start opensearch
Überprüfen Sie, ob es ausgeführt wird:
curl -X GET "localhost:9200"
Sie sollten eine JSON-Antwort mit Clusterinformationen sehen.
Magento über Composer installieren
Die Composer-Methode ist der einzige empfohlene Installationsansatz. Es behandelt Abhängigkeiten ordnungsgemäß und macht Aktualisierungen unkompliziert. Vermeiden Sie Archiv-Downloads oder Git-Klone für Produktionsstandorte.
Schritt 1: Holen Sie sich Magento-Authentifizierungsschlüssel
Zum Herunterladen von Magento benötigen Sie Authentifizierungsschlüssel. Erstellen Sie ein kostenloses Konto unter marketplace.magento.com, dann:
- Go to My Profile > Access Keys
- Klicken “Erstellen Sie einen neuen Zugriffsschlüssel”
- Nennen Sie es (z.B, “Serverinstallation”)
- Kopieren Sie den öffentlichen Schlüssel (Nutzername) und privater Schlüssel (Passwort)
Speichern Sie diese Schlüssel in der globalen Authentifizierungsdatei von Composer:
composer global config http-basic.repo.magento.com <public_key> <private_key>
Schritt 2: Erstellen Sie das Webverzeichnis
Erstellen Sie Ihr Webstammverzeichnis und navigieren Sie zu diesem:
sudo mkdir -p /var/www/magento2
cd /var/www/magento2
Schritt 3: Laden Sie Magento herunter
Führen Sie den Composer-Befehl „create-project“ aus. Für Magento Open Source:
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition .
Für Adobe Commerce (kostenpflichtige Version):
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition .
Dadurch werden mehr als 300 MB Dateien heruntergeladen. Sei geduldig.
Schritt 4: Legen Sie die Dateiberechtigungen fest
Richtige Berechtigungen verhindern “Zugriff verweigert” Fehler und Sicherheitsprobleme:
sudo find var generated vendor pub/static pub/media app/etc -type f -exec chmod 644 {} \;
sudo find var generated vendor pub/static pub/media app/etc -type d -exec chmod 755 {} \;
sudo chown -R www-data:www-data /var/www/magento2
sudo chmod u+x bin/magento
Schritt 5: Führen Sie den Installationsbefehl aus
Führen Sie nun die eigentliche Installation durch. Passen Sie diese Parameter an Ihr Setup an:
bin/magento setup:install \
--base-url="https://yourdomain.com/" \
--db-host="localhost" \
--db-name="magento2" \
--db-user="magento_user" \
--db-password="your_strong_password" \
--admin-firstname="Admin" \
--admin-lastname="User" \
--admin-email="[email protected]" \
--admin-user="admin" \
--admin-password="Admin123!" \
--language="en_US" \
--currency="USD" \
--timezone="America/New_York" \
--use-rewrites=1 \
--search-engine="opensearch" \
--opensearch-host="localhost" \
--opensearch-port="9200"
Die Installation dauert 5-15 Minuten abhängig von der Servergeschwindigkeit. Achten Sie auf etwaige Fehler.
Wenn es fertig ist, Sie sehen eine Nachricht mit Ihrer Admin-URL. Aus Sicherheitsgründen ist es randomisiert (z.B, /admin_abc123). Schreiben Sie dies auf.
Schritt 6: Führen Sie Befehle nach der Installation aus
Schließen Sie das Setup mit diesen wichtigen Befehlen ab:
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
Das static-content:deploy Der Befehl generiert CSS- und JavaScript-Dateien. Das -f Flag erzwingt die Bereitstellung im Entwicklermodus.
Nginx für Magento konfigurieren
Magento benötigt eine spezielle Nginx-Konfiguration. Erstellen Sie einen neuen Serverblock:
sudo nano /etc/nginx/sites-available/magento2
Fügen Sie diese Konfiguration hinzu (Domäne und Pfade anpassen):
upstream fastcgi_backend {
server unix:/var/run/php/php8.2-fpm.sock;
}
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
set $MAGE_ROOT /var/www/magento2;
set $MAGE_MODE production;
include /var/www/magento2/nginx.conf.sample;
}
Aktivieren Sie die Site und testen Sie die Konfiguration:
sudo ln -s /etc/nginx/sites-available/magento2 /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
Magento bietet eine Beispiel-Nginx-Konfiguration unter nginx.conf.sample. Die obige Include-Direktive verwendet es direkt.
Cron-Jobs einrichten
Magento ist stark auf Cron-Jobs angewiesen (geplante Aufgaben) zur Indizierung, E-Mails, Sitemaps, und mehr. Ohne Cron, Ihr Shop funktioniert nicht richtig.
Führen Sie diesen Befehl aus, um die Crontab-Einträge zu generieren:
bin/magento cron:install
Dadurch werden drei Cron-Jobs hinzugefügt. Stellen Sie sicher, dass sie vorhanden sind:
crontab -l
Sie sollten jede Minute Einträge für die geplanten Aufgaben von Magento sehen.
Leistungsoptimierung: Redis und Lack
Ein Magento-Produktionsshop benötigt Caching für eine akzeptable Leistung. Redis verwaltet Sitzungen und Backend-Cache. Lack (ein HTTP-Beschleuniger) kümmert sich um das Ganzseiten-Caching.
Redis installieren
sudo apt install redis-server -y
sudo systemctl enable redis-server
Überprüfen Sie, ob Redis funktioniert:
redis-cli ping
Es sollte mit antworten “PONG”.
Konfigurieren Sie Magento so, dass Redis für das Caching verwendet wird:
bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0
bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1
bin/magento setup:config:set --session-save=redis --session-save-redis-host=127.0.0.1 --session-save-redis-db=2
Verwendung separater Datenbanken (0, 1, 2) Hält verschiedene Cache-Typen isoliert.
Lack installieren
Varnish sitzt vor Ihrem Webserver und speichert Seiten zwischen:
sudo apt install varnish -y
Magento generiert die Varnish-Konfigurationsdatei:
bin/magento varnish:vcl:generate --backend-host=localhost --backend-port=8080 --output-file=/etc/varnish/default.vcl
Sie müssen Nginx so anpassen, dass es den Port überwacht 8080 intern, während Varnish den Port verwaltet 80. Dieses Setup erfordert eine zusätzliche Konfiguration, die über den Rahmen dieses Handbuchs hinausgeht, aber die Magento-Dokumentation deckt es ausführlich ab.
Sicherheitskonfiguration
Die Sicherung von Magento erfordert mehrere Schritte. Überspringen Sie diese nicht.
Sicherheit im Admin-Panel
Log into the Magento admin panel and navigate to Stores > Configuration > Advanced > Admin.
Unter Sicherheit, Konfigurieren Sie diese Einstellungen:
- Freigabe des Administratorkontos: Stellen Sie auf ein “Nein” (verhindert, dass mehrere Personen ein Login verwenden)
- Passwort-Lebensdauer: Stellen Sie auf ein 90 Tage
- Maximale Anzahl an Anmeldefehlern: Stellen Sie auf ein 5
- Sperrzeit: Stellen Sie auf ein 30 Protokoll
Zwei-Faktor-Authentifizierung
Magento 2.4+ ermöglicht die Zwei-Faktor-Authentifizierung (2FA) standardmäßig. Dies fügt über die Passwörter hinaus einen zweiten Verifizierungsschritt hinzu. Sie können es nicht deaktivieren, also konfigurieren Sie es richtig:
- Go to Stores > Configuration > Security > 2FA
- Aktivieren Sie Google Authenticator (oder einem anderen unterstützten Anbieter)
- Beim ersten Login, Scannen Sie den QR-Code mit Ihrer Authentifizierungs-App
Dateiberechtigungen
Nach der Installation, Berechtigungen verschärfen:
sudo find /var/www/magento2 -type d -exec chmod 755 {} \;
sudo find /var/www/magento2 -type f -exec chmod 644 {} \;
sudo chmod -R 770 /var/www/magento2/var
sudo chmod -R 770 /var/www/magento2/pub/static
sudo chmod -R 770 /var/www/magento2/pub/media
sudo chmod -R 770 /var/www/magento2/generated
Admin-URL
Magento generiert während der Installation eine zufällige Admin-URL. Behalte es so. Ändern Sie es nicht in etwas Vorhersehbares wie /admin. Wenn Sie es später finden müssen:
bin/magento info:adminuri
SSL/HTTPS-Konfiguration
Verwenden Sie in der Produktion immer HTTPS. Nach der Installation eines SSL-Zertifikats (Let’s Encrypt ist kostenlos), Magento konfigurieren:
bin/magento setup:store-config:set --base-url="https://yourdomain.com/"
bin/magento setup:store-config:set --base-url-secure="https://yourdomain.com/"
bin/magento setup:store-config:set --use-secure=1
bin/magento setup:store-config:set --use-secure-admin=1
bin/magento cache:flush
Beheben häufiger Installationsprobleme
Auch bei sorgfältiger Einrichtung, Probleme passieren. Hier sind die häufigsten Probleme und Lösungen.
Installation bleibt hängen 70%
Dies bedeutet normalerweise PHPs max_execution_time ist zu niedrig. Bearbeiten Sie php.ini und setzen Sie es auf 18000, Starten Sie dann PHP-FPM neu. Alternative, Führen Sie die Installation über die Befehlszeile anstelle des Web-Installers aus.
“Klasse existiert nicht” Fehler
Diese ReflectionException-Fehler weisen auf beschädigte generierte Dateien hin. Räumen Sie sie auf:
rm -rf var/cache var/page_cache var/generation generated/code
bin/magento setup:di:compile
bin/magento cache:flush
Fehler wegen verweigerter Berechtigung
Dateiberechtigungen verursachen etwa 38% von Installationsfehlern. Stellen Sie sicher, dass der Webserver-Benutzer vorhanden ist (WWW-Daten auf Ubuntu) besitzt alle Dateien:
sudo chown -R www-data:www-data /var/www/magento2
Fehlende PHP-Erweiterung
Fehlermeldungen wie “Die angeforderte PHP-Erweiterung ext-mbstring fehlt” bedeutet, dass Sie diese Erweiterung installieren müssen:
sudo apt install php8.2-mbstring -y
sudo systemctl restart php8.2-fpm
Elasticsearch/OpenSearch-Verbindung fehlgeschlagen
Wenn Magento keine Verbindung zu Ihrer Suchmaschine herstellen kann:
- Überprüfen Sie, ob der Dienst ausgeführt wird:
sudo systemctl status opensearch - Konnektivität testen:
curl localhost:9200 - Überprüfen Sie, ob die Firewall-Regeln den Port blockieren 9200
- Stellen Sie sicher, dass der Hostname und der Port in Ihrem Installationsbefehl mit Ihrer Konfiguration übereinstimmen
Speicher erschöpft
PHP-Speicherfehler während der Kompilierung bedeuten, dass Sie mehr RAM oder Auslagerungsspeicher benötigen:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
Leere Seiten oder 500 Fehler
Aktivieren Sie den Entwicklermodus, um tatsächliche Fehler anzuzeigen:
bin/magento deploy:mode:set developer
Überprüfen Sie die Protokolldateien unter var/log/exception.log und var/log/system.log für Einzelheiten.
Checkliste nach der Installation
Nach erfolgreicher Installation, Führen Sie diese Schritte aus:
- Melden Sie sich im Admin-Bereich an und konfigurieren Sie die Shop-Einstellungen (Name, Zeitzone, Währung)
- Versandarten einrichten
- Konfigurieren Sie Zahlungsgateways
- Erstellen Sie Kundengruppen und Steuerregeln
- E-Mail-Vorlagen und SMTP einrichten
- Konfigurieren Sie robots.txt und Sitemaps
- Installieren Sie wichtige Erweiterungen über Composer
- Richten Sie automatisierte Backups ein
- Wechseln Sie in den Produktionsmodus:
bin/magento deploy:mode:set production
Häufig gestellte Fragen
Kann ich Magento auf Shared Hosting installieren??
Technisch gesehen ja, aber es wird nicht empfohlen. Magento erfordert spezielle PHP-Konfigurationen, SSH-Zugang, und Komponist. Die meisten Shared Hosts bieten diese nicht an. Außerdem stoßen Sie schnell an die Speichergrenzen. VPS-Hosting ist die minimale praktische Option.
Wie lange dauert die Magento-Installation??
Die Servervorbereitung dauert 30-60 Minuten, wenn Sie mit Linux vertraut sind. Die eigentliche Magento-Installation dauert 10-20 Protokoll. Erstbenutzer sollten ein Budget einplanen 2-4 Stunden für den kompletten Prozess inklusive Fehlerbehebung.
Benötige ich Elasticsearch oder OpenSearch??
Ja, einer davon ist für Magento obligatorisch 2.4+. MySQL führt keine Katalogsuche mehr durch. OpenSearch ist die empfohlene Wahl für Neuinstallationen, da es vollständig Open Source ist und aktiv gepflegt wird.
Was ist der Unterschied zwischen Magento Open Source und Adobe Commerce??
Magento Open Source ist kostenlos und wird von der Community unterstützt. Adobe Commerce (ehemals Magento Commerce) ist die kostenpflichtige Version mit zusätzlichen Funktionen wie B2B-Funktionalität, Erweiterte Marketing-Tools, und Cloud-Hosting-Optionen. Adobe Commerce beginnt bei 22.000 $/Jahr. Beide nutzen den gleichen Installationsprozess.
Kann ich von WooCommerce auf Magento migrieren??
Ja, aber es erfordert eine sorgfältige Planung. Sie müssen Produkte exportieren, Kunden, und Bestellungen aus WooCommerce importieren und in Magento importieren. Es gibt mehrere Migrationserweiterungen, Obwohl komplexe Geschäfte möglicherweise eine individuelle Entwicklung benötigen. Erwägen Sie die Beauftragung eines Magento-Spezialisten für große Kataloge.
Wie aktualisiere ich Magento nach der Installation??
Verwenden Sie Composer zum Aktualisieren: composer update magento/product-community-edition --with-all-dependencies. Sichern Sie immer zuerst Ihre Datenbank und Dateien. Testen Sie Updates vor der Produktion in einer Staging-Umgebung. Laufen bin/magento setup:upgrade nach dem Update.
Warum ist mein Magento-Shop langsam??
Nicht zwischengespeichertes Magento ist von Natur aus langsam. Es generiert Seiten dynamisch. Aktivieren Sie Redis für Backend-Caching und Varnish für Ganzseiten-Caching. Aktivieren Sie den Produktionsmodus, wodurch der Code vorkompiliert wird. Verwenden ein CDN für statische Vermögenswerte. Erwägen Sie ein Upgrade Ihres Serverressourcen wenn der Verkehr hoch ist.

