So installieren Sie die Magento eCommerce-Plattform auf Ubuntu 24.04

Magento ist eine Open-Source- und bekannte eCommerce-Plattform, die in PHP geschrieben ist. Magento ist eine robuste und leistungsstarke eCommerce-Lösung, die von mehr als 240.000 Händlern weltweit genutzt wird. Magento ist eine vielseitige und skalierbare Plattform zum Erstellen eines eCommerce-Shops. Es eignet sich für den Aufbau kleiner, mittlerer und großer Online-Shops. Magento ermöglicht es Ihnen, Ihre Online-Shops auf Ihrem Server zu erstellen und zu hosten.

In diesem Leitfaden führen wir Sie durch die Installation von Magento eCommerce auf dem Ubuntu 22.04-Server.

Voraussetzungen

Um mit diesem Leitfaden zu beginnen, stellen Sie sicher, dass Sie Folgendes vorbereitet haben:

• Ein Ubuntu 24.04 mit mindestens 4 GB Speicher.
• Ein Nicht-Root-Benutzer mit Sudo-Rechten.
• Einen Domainnamen, der auf eine Server-IP-Adresse verweist.

Abhängigkeiten installieren

Bevor Sie mit der Installation beginnen, müssen Sie sicherstellen, dass die Abhängigkeiten von Magento installiert sind. In diesem Abschnitt installieren Sie Softwarepakete für Magento, zu denen OpenSearch, Nginx, MySQL-Server, PHP-FPM, Redis, Composer und Git gehören.

Zuerst installieren Sie die Pakete ‘ apt-transport-https ‘ und ‘ gnupg ‘ mit folgendem Befehl:

sudo apt install apt-transport-https gnupg -y

Führen Sie den folgenden Befehl aus, um den OpenSearch GPG-Schlüssel und das Repository für Debian/Ubuntu-basierte Distributionen hinzuzufügen.

curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | \  
sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/opensearch-keyring

echo "deb [signed-by=/usr/share/keyrings/opensearch-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | \  
sudo tee /etc/apt/sources.list.d/opensearch-2.x.list

Jetzt aktualisieren Sie Ihren Ubuntu-Paketindex und installieren die Abhängigkeiten mit dem folgenden apt-Befehl. Damit installieren Sie die Pakete OpenSearch, Nginx, MySQL, PHP-FPM, Redis, Composer und Git.

sudo apt update && sudo apt install opensearch nginx mysql-server composer git redis-server php-fpm php-bcmath php-common php-mbstring php-xmlrpc php-soap php-gd php-xml php-intl php-mysql php-cli php-redis php-ldap php-zip php-curl php-imagick

Geben Sie Y ein, um die Installation zu bestätigen.

Nach der Installation überprüfen Sie alle Dienste, um sicherzustellen, dass sie laufen.

Überprüfen Sie den Nginx-Dienst mit folgendem Befehl. Sie werden sehen, dass der Nginx-Dienst läuft und aktiviert ist.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Überprüfen Sie jetzt den MySQL-Server mit dem folgenden Befehl. Sie können in der Ausgabe sehen, dass der MySQL-Server läuft.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Überprüfen Sie den PHP-FPM-Dienst mit folgendem Befehl. Der PHP-FPM sollte automatisch laufen und aktiviert sein.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

Überprüfen Sie den Redis-Server mit dem folgenden Befehl. Sie sollten sehen, dass Redis läuft und aktiviert ist.

sudo systemctl is-enabled redis-server  
sudo systemctl status redis-server

Überprüfen Sie zuletzt die Composer-Version mit folgendem Befehl. Sie sollten Composer v2.7 auf Ihrem System installiert haben.

sudo -u www-data composer -v

OpenSearch einrichten

Nachdem Sie die Abhängigkeiten installiert haben, müssen Sie OpenSearch konfigurieren. Magento verwendet OpenSearch für die erweiterte Produktsuche und Indizierung. In diesem Abschnitt erhöhen Sie den standardmäßigen maximalen Heap-Speicher und deaktivieren das Sicherheits-Plugin von OpenSearch (nur für eine Entwicklungsumgebung).

Öffnen Sie die Datei ‘ /etc/opensearch/jvm.options ‘ mit dem folgenden Nano-Editor.

sudo nano /etc/opensearch/jvm.options

Ändern Sie die standardmäßige Speicherzuweisung für OpenSearch nach Bedarf. In diesem Fall verwenden wir 2 GB für OpenSearch.

-Xms2g  
-Xmx2g

Speichern Sie die Datei und beenden Sie den Editor.

Öffnen Sie jetzt die Standardkonfiguration von OpenSearch ‘ /etc/opensearch/opensearch.yml ‘ mit dem Nano-Editor.

sudo nano /etc/opensearch/opensearch.yml

Fügen Sie die folgende Konfiguration hinzu, um das Sicherheits-Plugin in OpenSearch zu deaktivieren. Zu Demonstrationszwecken können Sie dies deaktivieren, aber in der Produktion müssen Sie das Sicherheits-Plugin aktivieren und TLS-Zertifikate für Ihre OpenSearch-Installation einrichten.

plugins.security.disabled: true

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie als Nächstes den folgenden Befehl aus, um den systemd-Manager neu zu laden. Nachdem Sie OpenSearch installiert haben, müssen Sie den systemd-Manager neu laden.

sudo systemctl daemon-reload

Starten, aktivieren und überprüfen Sie jetzt den OpenSearch-Dienst mit folgendem Befehl:

sudo systemctl enable --now opensearch  
sudo systemctl status opensearch

In der folgenden Ausgabe sehen Sie, dass OpenSearch läuft und aktiviert ist.

Überprüfen Sie zuletzt Ihre OpenSearch-Installation mit dem folgenden ‘ curl ‘ Befehl. Dies zeigt Ihnen grundlegende Informationen über Ihre OpenSearch-Installation.

curl -X GET http://localhost:9200

Unten sehen Sie, dass OpenSearch 2.14 auf dem Ubuntu-Server läuft.

PHP-FPM einrichten

In diesem Abschnitt werden Sie die Standardkonfiguration von PHP-FPM ändern und die Opcache-Erweiterung über die ‘php.ini’-Datei aktivieren. Sie werden das standardmäßige memory_limit erhöhen und die Option date.timezone anpassen.

Öffnen Sie die PHP-FPM-Konfiguration ‘ /etc/php/8.3/fpm/php.ini ‘ mit dem folgenden Nano-Editor.

sudo nano /etc/php/8.3/fpm/php.ini

Ändern Sie die Standardkonfiguration wie folgt. Passen Sie auch die date.timezone und memory_limit an Ihre aktuelle Serverumgebung an.

date.timezone = Europe/Amsterdam

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den folgenden Befehl aus, um den PHP-FPM-Dienst neu zu starten und Ihre Änderungen anzuwenden.

sudo systemctl restart php8.3-fpm

MySQL-Server einrichten

Nachdem Sie PHP-FPM konfiguriert haben, werden Sie im nächsten Abschnitt die MySQL-Serverinstallation einrichten und eine neue Datenbank und einen neuen Benutzer für Magento erstellen.

Sichern Sie Ihre MySQL-Serverinstallation, indem Sie den folgenden Befehl ausführen.

sudo mysql_secure_installation

Unten werden Sie nach den MySQL-Serverkonfigurationen gefragt:

• Geben Sie y ein, um die VALIDATE PASSWORD-Komponente zu aktivieren.
• Geben Sie 1 ein, um die Passwortstärke auf MEDIUM einzustellen.
• Geben Sie y ein, wenn Sie gefragt werden, ob Sie Ihr MySQL-Root-Passwort ändern möchten.
• Geben Sie y ein, um den standardmäßigen anonymen Benutzer zu entfernen.
• Geben Sie y ein, um die Remote-Anmeldung für den MySQL-Root-Benutzer zu verweigern.
• Geben Sie erneut y ein, um die standardmäßige Testdatenbank von MySQL zu entfernen.
• Geben Sie schließlich y ein, um die MySQL-Tabellenberechtigungen neu zu laden und die Änderungen anzuwenden.

Nachdem Sie MySQL konfiguriert haben, müssen Sie eine neue Datenbank und einen neuen Benutzer für Magento erstellen.

Melden Sie sich mit dem folgenden Befehl beim MySQL-Server an. Geben Sie Ihr MySQL-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mysql -u root -p

Führen Sie jetzt die folgenden Abfragen aus, um eine neue Datenbank und einen neuen Benutzer für Magento zu erstellen. In diesem Beispiel erstellen Sie einen neuen Benutzer und eine Datenbank ‘ magento ‘ mit dem Passwort ‘ M4gentoPassw0rd__ ‘.

Stellen Sie sicher, dass Sie die folgenden Details mit Ihren Informationen ändern. Außerdem sollte das MySQL-Passwort für Magento ein Sonderzeichen, eine Zahl und einen Großbuchstaben enthalten.

CREATE DATABASE magento;  
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'M4gentoPassw0rd__';  
GRANT ALL PRIVILEGES ON magento.* to 'magento'@'localhost';  
FLUSH PRIVILEGES;

Führen Sie als Nächstes die folgende Abfrage aus, um die Berechtigungen für den Benutzer ‘ magento ‘ zu überprüfen. Stellen Sie sicher, dass Ihr Benutzer auf die Datenbank ‘ magento ‘ zugreifen kann.

SHOW GRANTS FOR magento@localhost;

Geben Sie zuletzt quit ein, um den MySQL-Server zu verlassen.

Magento über die Befehlszeile installieren

In diesem Abschnitt werden Sie den Magento-Quellcode herunterladen und PHP-Abhängigkeiten mit Composer installieren. Dann installieren Sie Magento über die Befehlszeile. Zum Schluss generieren Sie einen Crontab für Magento.

Gehen Sie in das ‘ /var/www ‘ Verzeichnis und laden Sie den Magento-Quellcode mit dem folgenden wget-Befehl herunter. Überprüfen Sie die Magento-GitHub-Seite und holen Sie sich die URL der neuesten Version von Magento.

cd /var/www  
wget https://github.com/magento/magento2/archive/refs/tags/2.4.7.tar.gz

Nachdem der Download abgeschlossen ist, extrahieren Sie den Magento-Quellcode und benennen Sie das extrahierte Verzeichnis in ‘magento2’ um. Damit sollte Ihre Magento-Installation im ‘/var/www/magento2’ Verzeichnis liegen.

tar -xf 2.4.7.tar.gz  
mv magento2-* magento2

Führen Sie jetzt den folgenden Befehl aus, um zusätzliche Verzeichnisse für Composer zu erstellen und den Besitz des ‘ /var/www ‘ Verzeichnisses auf den Benutzer ‘ www-data ‘ zu ändern.

sudo mkdir -p /var/www/{.config,.cache}  
sudo chown -R www-data:www-data /var/www

Führen Sie dann den folgenden Befehl aus, um dem Benutzer ‘ www-data ‘ die Berechtigung zu erteilen, innerhalb des ‘ /var/www/magento2 ‘ Verzeichnisses zu lesen, zu schreiben und auszuführen.

sudo chmod u+rwx /var/www/magento2

Gehen Sie als Nächstes in das ‘ /var/www/magento2 ‘ Verzeichnis und installieren Sie die PHP-Abhängigkeiten für Magento mit dem folgenden Composer-Befehl. Dies stellt sicher, dass Ihre Abhängigkeiten für Magento installiert sind.

cd /var/www/magento2  
sudo -u www-data composer install

Nachdem Sie die Abhängigkeiten installiert haben, führen Sie den folgenden Befehl aus, um dem Benutzer ‘ www-data ‘ die Berechtigung ‘ rwx ‘ für die Verzeichnisse ‘ generated ‘ und ‘ var ‘ innerhalb des Magento-Webstammverzeichnisses zu erteilen.

sudo chown -R www-data:www-data /var/www/magento2/var /var/www/magento2/generated  
sudo chmod u+rwx /var/www/magento2/var /var/www/magento2/generated  
sudo chmod g+rw /var/www/magento2/var /var/www/magento2/generated

Führen Sie jetzt den folgenden Befehl aus, um die Magento-Installation zu starten. Stellen Sie sicher, dass Sie die URL-Details, die MySQL-Datenbank, den Administratorbenutzer und das Passwort für Ihre Magento-Installation ändern.

sudo -u www-data bin/magento setup:install \  
--base-url=http://howtoforge.local \  
--db-host=localhost \  
--db-name=magento2 \  
--db-user=magento \  
--db-password=M4gentoPassw0rd__ \  
--admin-firstname=bob \  
--admin-lastname=admin \  
--admin-email=[email protected] \  
--admin-user=bob \  
--admin-password=BobAdm1nP4ssword \  
--currency=USD \  
--timezone=Europe/Amsterdam \  
--use-rewrites=1 \  
--session-save=redis \  
--search-engine=opensearch \  
--opensearch-host=127.0.0.1 \  
--opensearch-port=9200 \  
--opensearch-enable-auth=0 \  
--opensearch-index-prefix=magento22 \  
--opensearch-timeout=30

Unten sehen Sie, wie die Magento-Installation beginnt:

Sobald die Installation abgeschlossen ist, sehen Sie die Ausgabe ‘ Magento-Installation abgeschlossen.’ und den Admin-URL-Pfad für Ihre Magento-Installation. Stellen Sie sicher, dass Sie die generierte URL für die Magento-Admin-Seite speichern.

Um die Magento-Installation abzuschließen, führen Sie den folgenden Befehl aus, um den Crontab für Magento zu generieren und die Indizierung für Magento auszuführen.

sudo -u www-data bin/magento cron:install  
sudo -u www-data bin/magento cron:run --group index

Sie können die Liste des Crontabs für den Benutzer ‘www-data’ mit folgendem Befehl überprüfen:

crontab -u www-data -l

Sie können sehen, dass der Crontab für Magento generiert wurde.

Führen Sie zuletzt den folgenden Befehl aus, um den Cache Ihrer Magento-Installation zu leeren. Damit haben Sie die Magento-Installation abgeschlossen, als Nächstes müssen Sie den Nginx-Webserver einrichten.

sudo -u www-data bin/magento cache:clean

Nginx-Serverblock einrichten

An diesem Punkt ist Ihre Magento-Installation abgeschlossen, jetzt werden Sie einen neuen Nginx-Server erstellen, um Ihre Magento-Installation auszuführen. Stellen Sie sicher, dass Sie einen Domainnamen haben, der auf Ihre Server-IP-Adresse verweist.

Erstellen Sie eine neue Nginx-Serverblockkonfiguration ‘ /etc/nginx/sites-available/magento.conf ‘ mit dem Nano-Editor.

sudo nano /etc/nginx/sites-available/magento.conf

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die server_name-Option mit Ihrem Magento-Domainnamen ändern.

upstream fastcgi_backend {  
 server unix:/run/php/php8.3-fpm.sock;  
}  
  
server {  
 listen 80;  
 listen [::]:80;  
 server_name howtoforge.local;  
 set $MAGE_ROOT /var/www/magento2/;  
 include /var/www/magento2/nginx.conf.sample;  
 client_max_body_size 2M;  
  
 access_log /var/log/nginx/magento.access;  
 error_log /var/log/nginx/magento.error;  
}

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den folgenden Befehl aus, um den Serverblock ‘ magento.conf ‘ zu aktivieren und Ihre Nginx-Syntax zu überprüfen. Stellen Sie sicher, dass Sie die Ausgabe ‘ Syntax ist ok - Test war erfolgreich ‘ erhalten.

sudo ln -s /etc/nginx/sites-available/magento.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Starten Sie zuletzt den Nginx-Dienst mit folgendem Befehl neu, um Ihre neue Serverblockkonfiguration anzuwenden. Nach der Ausführung des Befehls wird Ihre Magento-Installation verfügbar sein.

sudo systemctl restart nginx

Magento mit HTTPS sichern

Wenn Sie Magento in einer öffentlichen Domain ausführen, müssen Sie es mit HTTPS sichern. In diesem Abschnitt sichern Sie Ihre Magento-Installation mit HTTPS über Certbot und Letsencrypt.

Installieren Sie den Certbot und das Certbot Nginx-Plugin mit folgendem Befehl. Geben Sie Y ein, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-nginx

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um SSL/TLS-Zertifikate von Letsencrypt zu generieren. Stellen Sie sicher, dass Sie die E-Mail-Adresse und den Domainnamen unten mit Ihren Informationen ändern.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Ihre Magento-Installation sollte automatisch mit HTTPS gesichert sein, wenn der Prozess abgeschlossen ist. Ihre SSL/TLS-Zertifikate befinden sich im Verzeichnis ‘ /etc/letsencrypt/live/domain.com ‘.

Zugriff auf Magento

Öffnen Sie Ihren Webbrowser und besuchen Sie Ihren Magento-Domainnamen wie https://howtoforge.local. Wenn Ihre Installation erfolgreich war, sehen Sie die Standard-Magento-Indexseite wie folgt.

Besuchen Sie jetzt die Magento-Administrations-URL, die https://howtoforge.local/admin_ze87mmj ist. Überprüfen Sie den Installationsprozess.

Geben Sie Ihren Admin-Benutzer und Ihr Passwort für Magento ein und drücken Sie auf Anmelden.

Wenn alles erfolgreich war, sollten Sie das Magento-Administrations-Dashboard wie folgt erhalten:

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Magento eCommerce auf dem Ubuntu 24.04-Server abgeschlossen. Sie haben Magento mit dem LEMP-Stack (Linux, Nginx, MySQL und PHP-FPM), OpenSearch und Redis installiert. Sie haben Magento auch mit HTTPS über Certbot und Letsencrypt gesichert.