Mengonfigurasi dan Menggunakan Mesin Pencari Meilisearch di ServBay

Meilisearch adalah mesin pencari open-source yang sangat kuat, sangat cepat, dan mudah digunakan, dirancang khusus untuk memberikan pengalaman “search-as-you-type” yang luar biasa. Meilisearch menawarkan beragam fitur lewat API RESTful yang sederhana. Dengan ServBay, menjalankan instance Meilisearch yang lengkap di lingkungan lokal macOS Anda menjadi sangat mudah.

Ringkasan

ServBay telah mengintegrasikan Meilisearch ke dalam antarmuka grafisnya, memungkinkan developer memasang dan mengonfigurasi hanya dengan satu klik—tak perlu repot dengan command line atau urusan dependensi. ServBay juga secara otomatis menyiapkan dashboard web built-in untuk Meilisearch, yang bisa Anda akses langsung melalui domain praktis https://meilisearch.servbay.host/ untuk mengelola indeks, menguji pencarian, dan memantau status instance.

Prasyarat

• ServBay sudah sukses diinstal dan dijalankan di macOS Anda.
• Anda memiliki proyek pengembangan yang membutuhkan fungsi pencarian.
• Sudah memahami konsep dasar mesin pencari (seperti Index, Document, API Key).

Langkah-langkah

1. Instal Paket Meilisearch

Pertama, instal paket Meilisearch melalui manajer paket ServBay:

1. Buka aplikasi ServBay.
2. Di sidebar kiri, klik Paket (Packages).
3. Temukan Search - Meilisearch dalam daftar paket.
4. Klik tombol instal di sisi kanan Meilisearch, lalu tunggu hingga proses selesai.
5. Klik tombol aktifkan untuk mengaktifkan layanan Meilisearch.

2. Konfigurasi Layanan Meilisearch

Setelah instalasi selesai, Anda bisa mengatur konfigurasi detail untuk Meilisearch:

1. Di sidebar kiri ServBay, klik Search.

2. Pada menu dropdown, pilih Meilisearch untuk masuk ke halaman konfigurasi.

   

3. Atur beberapa opsi berikut sesuai kebutuhan Anda:

   • Bind IP: Alamat IP yang akan didengarkan Meilisearch. Default-nya 127.0.0.1, artinya layanan hanya bisa diakses secara lokal—praktik terbaik untuk keamanan pengembangan lokal.
   • Port: Port yang digunakan Meilisearch untuk API. Default-nya adalah 7700. Meski layanan berjalan di port ini, sangat disarankan untuk selalu mengakses Meilisearch melalui domain yang disediakan ServBay: https://meilisearch.servbay.host.
   • Master Key: Ini adalah kredensial terpenting untuk melindungi instance Meilisearch Anda. Semua permintaan API (termasuk membuat, mengubah, dan menghapus indeks) harus diotorisasi dengan key ini. Buatlah key yang rumit dan unik, serta simpan dengan aman.
   • Data Path: Jalur lokal tempat Meilisearch menyimpan semua indeks dan file database. Default-nya /Applications/ServBay/data/meilisearch. Anda bisa klik ikon folder di kanan untuk langsung membuka folder ini di Finder.
   • Runtime Environment: Pilih mode Development (Pengembangan) atau Production (Produksi). Mode Development menyediakan laporan kesalahan dan petunjuk API yang detail—ideal untuk tahap pengembangan. Mode Production menonaktifkan informasi detail ini agar performa lebih optimal.
   • Log Level: Atur tingkat kedetailan log—bisa INFO, DEBUG, WARN, ERROR, dan sebagainya, untuk memudahkan debugging.

3. Simpan Konfigurasi & Mulai Layanan

1. Setelah semua pengaturan selesai, klik tombol Save (Simpan) di kanan bawah.
2. ServBay akan otomatis menerapkan pengaturan Anda dan mencoba memulai atau me-restart layanan Meilisearch.
3. Perhatikan indikator status di samping entri Meilisearch—hijau berarti layanan sudah berjalan dengan sukses.

4. Akses Dashboard Web Meilisearch

ServBay menyediakan cara yang sangat praktis untuk mengakses dashboard manajemen Meilisearch:

1. Cara pertama (disarankan): Di pojok kanan atas halaman konfigurasi Meilisearch, klik ikon browser (ikon kompas), dan ServBay akan langsung membuka dashboard di browser default Anda.

2. Cara kedua: Ketik langsung alamat https://meilisearch.servbay.host/ di browser.

   

Di dashboard ini, Anda dapat:

• Membuat dan mengelola indeks.
• Menguji query pencarian secara visual dan melihat hasilnya.
• Melihat status task (misal penambahan dokumen, update pengaturan, dll).
• Mengatur API Key Anda.

5. Mengintegrasikan Meilisearch dalam Aplikasi Anda

Gunakan library client Meilisearch resmi ataupun komunitas untuk berinteraksi dengan instance lokal.

Ketika melakukan koneksi, gunakan informasi berikut:

• Host: https://meilisearch.servbay.host (harus mencakup https://)
• API Key: Master Key yang Anda atur pada Langkah 2

Contoh Kode PHP (dengan meilisearch/meilisearch-php)

Pertama, instal library client di proyek PHP Anda:

composer require meilisearch/meilisearch-php

Kemudian, gunakan kode berikut untuk menghubungkan dan beroperasi:

<?php
require_once 'vendor/autoload.php';

use MeiliSearch\Client;

// Inisialisasi client Meilisearch
$client = new Client('https://meilisearch.servbay.host', 'YOUR-STRONG-MASTER-KEY'); // Ganti dengan Master Key Anda sendiri

try {
    // 1. Membuat atau mengambil sebuah indeks
    $index = $client->index('movies');

    // 2. Menambahkan dokumen
    $documents = [
        ['id' => 1, 'title' => 'Carol', 'genres' => ['Romance', 'Drama']],
        ['id' => 2, 'title' => 'Wonder Woman', 'genres' => ['Action', 'Adventure']],
        ['id' => 3, 'title' => 'Life of Pi', 'genres' => ['Adventure', 'Drama']],
        ['id' => 4, 'title' => 'Mad Max: Fury Road', 'genres' => ['Action', 'Adventure']],
        ['id' => 5, 'title' => 'Moana', 'genres' => ['Fantasy', 'Action']],
        ['id' => 6, 'title' => 'Philadelphia', 'genres' => ['Drama']],
    ];
    $index->addDocuments($documents);
    echo "Dokumen berhasil ditambahkan ke indeks 'movies'.\n";

    // Tunggu sebentar agar Meilisearch sempat memproses task
    sleep(1); 

    // 3. Melakukan pencarian
    $searchResults = $index->search('max');
    print_r($searchResults->getHits());

} catch (\Exception $e) {
    echo "Meilisearch Error: {$e->getMessage()}\n";
}

FAQ (Pertanyaan yang Sering Diajukan)

• Q: Saya lupa Master Key, apa yang harus saya lakukan?
  • A: Cukup buka konfigurasi Meilisearch di ServBay, masukkan Master Key baru dan klik Save (Simpan). ServBay akan otomatis menerapkan key baru dan me-restart layanan.
• Q: Meilisearch gagal dijalankan, bagaimana cara troubleshooting?
  • A: Klik ikon log di pojok kanan atas halaman konfigurasi Meilisearch untuk melihat log real-time—biasanya akan muncul pesan kesalahan yang jelas. Selain itu, pastikan port lokal 7700 tidak dipakai aplikasi lain.
• Q: Apa beda jelas antara Development dan Production pada “Runtime Environment”?
  • A: Dalam mode Development, respons API akan berisi info error dan stack trace yang sangat detail—memudahkan debugging namun berpotensi mengungkap detail sensitif. Mode Production hanya akan mengembalikan pesan error umum, lebih aman dan lebih cepat—cocok untuk lingkungan produksi atau jika Anda tidak memerlukan debugging detail.

Ringkasan

Kombinasi ServBay dan Meilisearch menghadirkan pengalaman pengembangan search lokal yang kuat dan mulus bagi para developer macOS. Dengan manajemen grafis yang simpel dan dashboard web siap pakai, Anda dapat lebih fokus membangun fitur search inti aplikasi tanpa terhambat pengaturan lingkungan teknis yang rumit.