Skip to main content

Introduction to MeiLi Search with Docker

Guangzhou, China

See also:

In this guide you will learn how to use Docker to download and run Meilisearch, configure its behavior, and manage your Meilisearch data.

Setup MeiLi Search with Docker

Use the docker pull command to download the latest Meilisearch image:

docker pull getmeili/meilisearch:latest

After completing the previous step, use docker run to launch the Meilisearch image. To persist the data I will create a meili directory and mount it into the container:

sudo mkdir /opt/meili_data
sudo chown myuser:myuser /opt/meili_data
docker run -it --rm \
-p 7700:7700 \
-v /opt/meili_data:/meili_data \
getmeili/meilisearch:latest
888b     d888          d8b 888 d8b                                            888
8888b d8888 Y8P 888 Y8P 888
88888b.d88888 888 888
888Y88888P888 .d88b. 888 888 888 .d8888b .d88b. 8888b. 888d888 .d8888b 88888b.
888 Y888P 888 d8P Y8b 888 888 888 88K d8P Y8b "88b 888P" d88P" 888 "88b
888 Y8P 888 88888888 888 888 888 "Y8888b. 88888888 .d888888 888 888 888 888
888 " 888 Y8b. 888 888 888 X88 Y8b. 888 888 888 Y88b. 888 888
888 888 "Y8888 888 888 888 88888P' "Y8888 "Y888888 888 "Y8888P 888 888

Config file path: "none"
Database path: "./data.ms"
Server listening on: "http://0.0.0.0:7700"
Environment: "development"
Commit SHA: "5e12af88e2575a42f53bb3907aea42d7cd4b8b20"
Commit date: "2023-02-01T11:07:46+00:00"
Package version: "1.0.0"

But I am receiving the following warning:

No master key was found. The server will accept unidentified requests. A master key of at least 16 bytes will be required when switching to a production environment. We generated a new secure master key for you (you can safely use this token):

>> --master-key RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ <<

Restart Meilisearch with the argument above to use this new and secure master key.

Ok :)

docker run -it --rm \
-p 7700:7700 \
-v /opt/meili_data:/meili_data \
-e MEILI_MASTER_KEY='RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ' \
getmeili/meilisearch:latest
A master key has been set. Requests to Meilisearch won't be authorized unless you provide an authentication key.

Add Documents

For this quick start, I will be using a collection of movies - a dataset provided in the MeiLi Docs. Move the downloaded file into your working directory. The REST API can be used with cURL:

curl \
-X POST 'http://localhost:7700/indexes/movies/documents?primaryKey=id' \
-H 'Content-Type: application/json' \
--data-binary @movies.json

But let's try using Python for fun - start by installing pip3 install meilisearch. The following script will not work though - just as the cURL request above - since we set up authentication:

import meilisearch
import json

client = meilisearch.Client('http://localhost:7700')

json_file = open('movies.json')
movies = json.load(json_file)
client.index('movies').add_documents(movies)

The Master Key should not be used for regular operations. So we first need to retrieve the API Key from MeiLi Search:

import meilisearch
import json

MASTER_KEY='RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ'

client = meilisearch.Client('http://localhost:7700', MASTER_KEY)
print(client.get_keys())

The response I get here is:

{"results": [{"name": "Default Search API Key", "description": "Use it to search from the frontend", "key": "0f96f66dcbc8f4d6e512592ec6e0f9e0b091de34a89147f244a93e3ab0709b7f", "uid": "9690e16c-9941-4dcf-addd-469e514e3226", "actions": ["search"], "indexes": ["*"], "expiresAt": null, "createdAt": "2023-02-10T06:18:07.098683943Z", "updatedAt": "2023-02-10T06:18:07.098683943Z"}, {"name": "Default Admin API Key", "description": "Use it for anything that is not a search operation. Caution! Do not expose it on a public frontend", "key": "992c6bd8233077bc83e537993ca3598aeb0e1113b0f89c0778d9523500aa6df2", "uid": "8e6bf9f2-3500-46b4-a875-76d695ac3ae1", "actions": ["*"], "indexes": ["*"], "expiresAt": null, "createdAt": "2023-02-10T06:18:07.095128284Z", "updatedAt": "2023-02-10T06:18:07.095128284Z"}], "offset": 0, "limit": 20, "total": 2}

So I am receiving two additional keys here beside the master key generated earlier:

KeyDescriptionValue
Master KeyUsed to setup MeiLi Search and generate the API keys below.RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ
Default Search API KeyUse it to search from the frontend.0f96f66dcbc8f4d6e512592ec6e0f9e0b091de34a89147f244a93e3ab0709b7f
Default Admin API KeyUse it for anything that is not a search operation. Caution! Do not expose it on a public frontend.992c6bd8233077bc83e537993ca3598aeb0e1113b0f89c0778d9523500aa6df2

We can extract those two keys with:

client_auth = meilisearch.Client('http://localhost:7700', MASTER_KEY)
api_keys = client_auth.get_keys()

SEARCH_KEY = api_keys["results"][0]["key"]
ADMIN_KEY = api_keys["results"][1]["key"]

print("Search Key:", search_key, "Admin Key:", admin_key)

With the authentication part dealt with, let's add our data:

client_admin = meilisearch.Client('http://localhost:7700', ADMIN_KEY)

json_file = open('movies.json')
movies = json.load(json_file)
client_admin.index('movies').add_documents(movies)

Search Documents

Now with Meilisearch set up, we can start searching with the search API key:

client_search = meilisearch.Client('http://localhost:7700', SEARCH_KEY)
results = client_search.index('movies').search('Casablanca')
print(results)
{"hits": [{"id": 289, "title": "Casablanca", "overview": "In Casablanca, Morocco in December 1941, a cynical American expatriate meets a former lover, with unforeseen complications.", "genres": ["Drama", "Romance"], "poster": "https://image.tmdb.org/t/p/w500/5K7cOHoay2mZusSLezBOY0Qxh8a.jpg", "release_date": -855187200}, {"id": 26940, "title": "A Night in Casablanca", "overview": "The Marx Brothers are employed at a hotel in postwar Casablanca, where a ring of Nazis is trying to recover a cache of stolen treasure.", "genres": ["Comedy"], "poster": "https://image.tmdb.org/t/p/w500/cXMT6KVIXEa9UI8ojEnBBYundrY.jpg", "release_date": -746236800}, {"id": 14208, "title": "The Librarian: Return to King Solomon's Mines", "overview": "After retrieving the Crystal Skull in Utah, Flynn Carsen receives a map in the mail with the secret location of King Solomon's Mines. When the scroll is stolen, Judson explains the power of the Key of Solomon's book and assigns Flynn to retrieve the map. The map is useless without the legend piece to decipher it, which is located in Volubilis near the Roman ruins in Morocco. Flynn heads to Casablanca to the ruins where he is chased by a group of mercenaries leaded by General Samir. They too want to find the location of King Solomon's mines. Flynn teams-up with Professor Emily Davenport working in the dig and they escape from General Samir and his men. While traveling to Gedi, they save the local Jomo from death and the trio faces a dangerous journey through the wild Africa.", "genres": ["Fantasy", "Action", "Adventure"], "poster": "https://image.tmdb.org/t/p/w500/jK4BhFw9uNS6BKfAVlxX6Bnkj0J.jpg", "release_date": 1157760000}], "query": "Casablanca", "processingTimeMs": 1, "limit": 20, "offset": 0, "estimatedTotalHits": 3}

CLI Search Client

import meilisearch
import json

MASTER_KEY='RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ'

# get API keys
client_auth = meilisearch.Client('http://localhost:7700', MASTER_KEY)
api_keys = client_auth.get_keys()

SEARCH_KEY = api_keys['results'][0]['key']

# search index
print("INFO :: Welcome to MeiLi Search!", '\n')
search_query = input("INPUT :: Please enter a name of a movie you want to search for: ")
client_search = meilisearch.Client('http://localhost:7700', SEARCH_KEY)
print("INFO :: MeiLi Search results for:", search_query, '\n')
results = client_search.index('movies').search(search_query)


for result in results['hits']:
print(result['title'].upper(), '||', result['overview'], '\n')

Rest API

List indices:

curl \
-X GET 'http://localhost:7700/indexes?limit=3' \
-H 'Authorization: Bearer RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ'

Create an index:

curl \
-X POST 'http://localhost:7700/indexes' \
-H 'Authorization: Bearer RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ' \
-H 'Content-Type: application/json' \
--data-binary '{
"uid": "my_blog",
"primaryKey": "id"
}'

Delete an index:

curl \
-X DELETE 'http://localhost:7700/indexes/movies' \
-H 'Authorization: Bearer RhTX1pLPSKSn7KW9yf9u_MNKC0v1YKkmx2Sc6qSwbLQ'