
Meilisearch einfach selbst hosten
Yulei ChenMeilisearch ist eine blitzschnelle, Open-Source Suchmaschine fuer moderne Apps. Du bekommst Typo-tolerante Volltextsuche, Filter, Faceting und sofortige Ergebnisse direkt out of the box. Meilisearch Cloud gibt es zwar, aber die Preise starten bei $30/Monat fuer Production-Use, und du bist an deren Infrastruktur gebunden.
Sliplane ist eine Managed Container Platform, die Self-Hosting einfach macht. Mit One-Click Deployment hast du Meilisearch in wenigen Minuten am Laufen - kein Server-Setup, kein Reverse Proxy, keine Infrastruktur zum Verwalten.
Voraussetzungen
Vor dem Deployment brauchst du einen Sliplane Account (kostenlose Testversion verfuegbar).
Quick Start
Sliplane bietet One-Click Deployment mit Presets.
- Klick auf den Deploy-Button oben
- Waehle ein Projekt aus
- Waehle einen Server. Wenn du dich gerade erst angemeldet hast, bekommst du einen 48-Stunden Trial-Server
- Klick auf Deploy!
Ueber das Preset
Das One-Click Deployment oben nutzt Sliplane's Meilisearch Preset. Das ist enthalten:
- Offizielles
getmeili/meilisearchDocker Image - Gepinnt auf Version v1.42.1 fuer Stabilitaet (check Docker Hub fuer neuere Versionen)
- Persistenter Storage gemountet auf
/meili_data, damit deine Indizes Neustarts ueberleben - Production Mode aktiviert (
MEILI_ENV=production) - Analytics standardmaessig deaktiviert (
MEILI_NO_ANALYTICS=true) - Ein zufaellig generierter Master Key fuer API-Authentifizierung
Naechste Schritte
Sobald Meilisearch auf Sliplane laeuft, erreichst du es ueber die Domain, die Sliplane bereitgestellt hat (z.B. meilisearch-xxxx.sliplane.app).
Authentifizierung
Meilisearch nutzt API-Key-basierte Authentifizierung. Im Production Mode brauchst du den Master Key, um auf die API zuzugreifen. Du findest ihn in der MEILI_MASTER_KEY Umgebungsvariable in deinen Sliplane Service Settings.
Der Master Key generiert automatisch zwei Standard-API-Keys:
- Default Search API Key: nur fuer Client-seitige Suchanfragen
- Default Admin API Key: fuer Indexierung, Settings und alle anderen Operationen
So rufst du die Keys ab - mit deinem Master Key ueber den Keys-Endpoint:
curl -H "Authorization: Bearer YOUR_MASTER_KEY" \
https://meilisearch-xxxx.sliplane.app/keys
Nutz den Admin API Key zum Indexieren und den Search API Key fuer Frontend-Queries. Gib deinen Master Key niemals in Client-seitigem Code preis.
Dokumente hinzufuegen
Um deine ersten Dokumente zu indexieren, schick einen POST-Request mit dem Admin API Key:
curl -X POST "https://meilisearch-xxxx.sliplane.app/indexes/movies/documents" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
--data-binary '[
{ "id": 1, "title": "The Matrix", "genre": "sci-fi" },
{ "id": 2, "title": "Inception", "genre": "sci-fi" },
{ "id": 3, "title": "Parasite", "genre": "thriller" }
]'
Umgebungsvariablen
Hier sind die wichtigsten Umgebungsvariablen, die du in deinen Sliplane Service Settings anpassen kannst:
| Variable | Standard | Beschreibung |
|---|---|---|
MEILI_MASTER_KEY | (generiert) | Master Key fuer API-Authentifizierung |
MEILI_ENV | production | Auf development setzen fuer detaillierte Fehlermeldungen |
MEILI_NO_ANALYTICS | true | Anonyme Analytics deaktivieren |
MEILI_MAX_INDEXING_MEMORY | (auto) | Max RAM fuer Indexierung, z.B. 1 GiB |
MEILI_MAX_INDEXING_THREADS | (auto) | Max Threads fuer Indexierung |
Alle Optionen findest du in der Meilisearch Konfigurations-Doku.
Logging
Meilisearch loggt standardmaessig nach STDOUT, was perfekt mit Sliplane's integriertem Log Viewer funktioniert. Du kannst das Log Level ueber die MEILI_LOG_LEVEL Umgebungsvariable anpassen. Mehr Logging-Tipps findest du in unserem Post how to use Docker logs.
| Variable | Optionen |
|---|---|
MEILI_LOG_LEVEL | ERROR, WARN, INFO (Standard), DEBUG, TRACE |
Troubleshooting
Wenn etwas nicht wie erwartet funktioniert, setz MEILI_LOG_LEVEL auf DEBUG in deinen Umgebungsvariablen und deploye neu. So bekommst du viel mehr Details darueber, was Meilisearch unter der Haube macht.
Du kannst auch den Health-Endpoint unter /health pruefen, um sicherzugehen, dass der Service laeuft. Eine gesunde Instanz gibt {"status":"available"} zurueck.
Kostenvergleich
Natuerlich kannst du Meilisearch auch bei anderen Cloud-Anbietern selbst hosten. Hier ein Preisvergleich der gaengigsten:
| Anbieter | vCPU Cores | RAM | Disk | Geschaetzte Monatskosten | Hinweise |
|---|---|---|---|---|---|
| Sliplane | 2 | 2 GB | 40 GB | €9 | Preis pro Server |
| Render | 1 | 2 GB | 40 GB | ~$35-$45 | VM Small |
| Fly.io | 2 | 2 GB | 40 GB | ~$20-$25 | VM + Volume |
| Railway | 2 | 2 GB | 40 GB | ~$15-$66 | Nutzungsbasiert |
FAQ
Wofuer kann ich Meilisearch nutzen?
Meilisearch ist perfekt fuer jede App, die schnelle, Typo-tolerante Suche braucht. Typische Anwendungsfaelle sind Produkt-Suche im E-Commerce, Dokumentations-Suche, Autocomplete und Content Discovery. Filter, Faceted Search und Geo Search sind direkt mit dabei.
Wie konfiguriere ich Search Ranking und Relevanz?
Meilisearch laesst dich Ranking-Regeln, durchsuchbare Attribute und filterbare Attribute pro Index anpassen. Das konfigurierst du ueber die Settings API. Du kannst zum Beispiel bestimmte Felder priorisieren oder eigene Ranking-Regeln basierend auf deinen Daten erstellen.
Wie update ich Meilisearch?
Aendere den Image Tag in deinen Service Settings (z.B. von v1.42.1 auf eine neuere Version) und deploye neu. Check Docker Hub fuer die neueste stabile Version. Meilisearch uebernimmt Datenbank-Migrationen automatisch beim Start.
Wie schneidet Meilisearch im Vergleich zu Elasticsearch ab?
Meilisearch ist fuer sofortige, nutzerorientierte Suche mit minimalem Setup gebaut. Elasticsearch ist maechiger fuer komplexe Analysen und Log-Aggregation, bringt aber deutlich mehr operativen Aufwand mit. Wenn du einfache, schnelle Suche fuer deine App brauchst, ist Meilisearch die bessere Wahl.
Wie viele Daten kann Meilisearch verarbeiten?
Meilisearch speichert seinen Index in Memory-Mapped Files, daher ist Disk Space dein Haupt-Limit. Mit dem Sliplane Starter-Plan und 40 GB Disk kannst du je nach Dokumentgroesse problemlos Millionen von Dokumenten indexieren. Fuer sehr grosse Datasets lohnt sich ein Upgrade auf einen Server mit mehr RAM und Disk.