OpenSearch in Magento einrichten

Magento braucht seit 2.4 zwingend eine Suchmaschine — und OpenSearch ist seit Version 2.4.6 der Standard dafür. Dieser Artikel zeigt die Einrichtung auf unseren Servern: Verbindung prüfen, Engine umstellen (im Admin oder per CLI), neu indexieren. Das Gegenstück für den Störungsfall ist OpenSearch in Magento: „No alive nodes found” beheben.

Voraussetzungen

• Eine laufende OpenSearch-Instanz. Zwei Wege bei uns: selbst betrieben als Container auf deinem Server (gut für Staging und kleinere Kataloge) oder als Managed OpenSearch — dediziert, überwacht, mit Updates von uns. Die Magento-Seite ist identisch, nur Adresse und Zugangsdaten unterscheiden sich.
• SSH-Zugang mit Zugriff auf bin/magento — siehe SSH-Zugang einrichten.
• Magento 2.4.6 oder neuer für die dedizierte OpenSearch-Engine (ältere Stände: siehe Kasten unten).

Schritt für Schritt

1. Prüfe die Verbindung zur Suchinstanz — vom Magento-Server aus:

   curl http://127.0.0.1:9200

   Kommt JSON mit der Versions-Info zurück, steht die Verbindung. Bei Managed OpenSearch mit Zugangsdaten und HTTPS: curl -u BENUTZER:PASSWORT https://HOST:9200
2. Stell die Konfiguration per CLI um (Beispielwerte anpassen):

   bin/magento config:set catalog/search/engine opensearch
   bin/magento config:set catalog/search/opensearch_server_hostname 127.0.0.1
   bin/magento config:set catalog/search/opensearch_server_port 9200
   bin/magento config:set catalog/search/opensearch_index_prefix magento2
   bin/magento config:set catalog/search/opensearch_enable_auth 0

   Bei Managed OpenSearch zusätzlich: Hostname inklusive https://, opensearch_enable_auth 1 sowie opensearch_username und opensearch_password setzen.
3. Dieselben Felder findest du alternativ im Admin unter Stores → Configuration → Catalog → Catalog Search — dort gibt es auch einen Button Test Connection für den direkten Gegencheck.
4. Nutzt du mehrere Umgebungen (Staging und Produktion) gegen dieselbe Instanz: Vergib pro Umgebung einen eigenen opensearch_index_prefix — sonst überschreiben sich die Indizes gegenseitig.
5. Leere den Cache und bau den Suchindex neu auf:

   bin/magento cache:clean config
   bin/magento indexer:reindex catalogsearch_fulltext

6. Teste die Storefront-Suche im Browser — Suchbegriffe, Kategorie-Listings, Filter. Ab jetzt beantwortet OpenSearch die Anfragen.

Magento 2.4.4 / 2.4.5: OpenSearch hinter Elasticsearch-Etikett

Erst mit 2.4.6 hat Magento eigene OpenSearch-Felder bekommen. Auf 2.4.4/2.4.5 sprichst du OpenSearch über die Elasticsearch-7-Felder an (catalog/search/engine elasticsearch7 plus elasticsearch7_server_hostname usw.) — OpenSearch versteht das API-kompatibel. Beim nächsten Magento-Update lohnt der Umzug auf die echten opensearch_*-Felder.

Wenn etwas schiefläuft

Reindex bricht mit No alive nodes found in your cluster ab

Magento erreicht die Instanz nicht — meist steckt der Fehler in Hostname, Protokoll oder Zugangsdaten, nicht im Suchserver.

Lösung: Der komplette Diagnose-Fahrplan steht im Artikel OpenSearch in Magento: „No alive nodes found” beheben.

opensearch taucht in der Engine-Auswahl nicht auf

Dein Magento ist älter als 2.4.6 — die dedizierte OpenSearch-Engine existiert dort noch nicht.

Lösung: Den Kompatibilitäts-Weg über die Elasticsearch-7-Felder nehmen (Kasten oben) — oder besser: das überfällige Magento-Update einplanen, ältere 2.4er-Stände bekommen keine Sicherheits-Patches mehr.

Die Suche liefert alte oder gar keine Treffer

Der Index passt nicht mehr zum Katalog — typisch direkt nach der Umstellung oder nach größeren Produkt-Importen.

Lösung: bin/magento indexer:reindex catalogsearch_fulltext ausführen und danach den Cache leeren — beides erklärt im Detail der Artikel Magento-Cache leeren und neu indexieren.

Verwandte Artikel

• OpenSearch in Magento: „No alive nodes found” beheben — wenn die Verbindung streikt.
• OpenSearch im Container für die Shop-Suche — der Unterbau, wenn du die Instanz selbst betreibst.
• Magento-Cache leeren und neu indexieren — die Handgriffe nach jeder Konfigurations-Änderung.

Du kommst nicht weiter?

Engine umgestellt und die Suche bleibt leer, oder unsicher, ob Container oder Managed OpenSearch zu deinem Katalog passt? Ticket im Kundencenter öffnen — nenn Shop-Domain und Magento-Version, wir schauen gemeinsam drauf.