OpenSearch im Container für die Shop-Suche

Magento (und andere Shops) brauchen eine Suchmaschine — OpenSearch läuft dafür problemlos als Container auf deinem Server. Ehrlich eingeordnet: Das Container-Setup ist ideal für Entwicklung, Staging und kleinere Kataloge. Für produktive Shops mit echtem Suchvolumen ist unser Managed OpenSearch die robustere Wahl — dediziert, überwacht, mit Updates von uns.

Voraussetzungen

• Rootless Docker + Compose — siehe Grundlagen und Compose.
• Freier RAM: OpenSearch will mindestens ~1 GB für sich (Java-Heap + Overhead).

Schritt für Schritt

1. Leg das Projekt an: mkdir -p ~/docker/opensearch && cd ~/docker/opensearch
2. Erstelle die compose.yaml:

   services:
     opensearch:
       image: opensearchproject/opensearch:2
       restart: unless-stopped
       environment:
         - discovery.type=single-node
         - DISABLE_SECURITY_PLUGIN=true
         - OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m
       ports:
         - "127.0.0.1:9200:9200"
       volumes:
         - opensearch-data:/usr/share/opensearch/data
   volumes:
     opensearch-data:

3. Starte den Dienst: docker compose up -d — der erste Start dauert etwas.
4. Teste ihn: curl http://127.0.0.1:9200 muss JSON mit der Versions-Info liefern.
5. Stell deinen Shop auf die Suche um — Host 127.0.0.1, Port 9200, ohne Authentifizierung. Durch die Anbindung führen die Artikel OpenSearch in Magento einrichten und OpenSearch in Shopware einrichten.

Security-Plugin aus = nur für localhost

DISABLE_SECURITY_PLUGIN=true schaltet Authentifizierung und TLS ab — vertretbar, weil der Dienst ausschließlich an 127.0.0.1 gebunden ist und nur deine eigene Anwendung ihn erreicht. Veröffentliche diesen Container niemals über den Reverse Proxy.

Wenn etwas schiefläuft

Magento meldet No alive nodes found in your cluster

Die Anwendung erreicht OpenSearch nicht — Container down, falscher Port oder Tippfehler in der Konfiguration.

Lösung: Den kompletten Diagnose-Fahrplan gibt es im Artikel „No alive nodes found” beheben — er passt eins zu eins auf das Container-Setup.

Der Container stirbt kurz nach dem Start (Exit-Code 137)

Zu wenig Speicher — 137 heißt: der Prozess wurde wegen RAM-Mangel beendet.

Lösung: Heap in OPENSEARCH_JAVA_OPTS nicht größer wählen, als der Server frei hat, und parallel laufende Dienste prüfen. Wird es eng, ist das das Signal für Managed OpenSearch oder mehr Server-RAM.

Die Suche ist bei größerem Katalog spürbar langsam

Ein Single-Node mit kleinem Heap hat natürliche Grenzen — mehr Produkte, Filter und parallele Sucher brauchen mehr Ressourcen.

Lösung: Heap moderat erhöhen (-Xms1g -Xmx1g) und den Verbrauch beobachten. Bleibt es zäh, per Ticket beraten lassen — oft ist der Umstieg auf das Managed-Produkt günstiger als der Kampf um RAM.

Verwandte Artikel

• OpenSearch in Magento einrichten und in Shopware — die Anbindung auf Shop-Seite.
• „No alive nodes found” beheben — die Verbindungs-Diagnose zwischen Shop und Suche.
• Docker Compose: Dienste dauerhaft betreiben — Volumes, Updates, Restart-Policies.
• ValKey/Redis als Cache — der zweite Performance-Baustein daneben.

Du kommst nicht weiter?

Suche bleibt leer, Container instabil oder unsicher, ob Container oder Managed die richtige Größe ist? Ticket im Kundencenter öffnen — wir rechnen das gemeinsam durch.