Installation

Download and launch

Download the latest stable release of MeiliSearch with curl.

Launch MeiliSearch to start the server.

$ curl -L https://install.meilisearch.com | sh
$ ./meilisearch
Server is listening on: http://127.0.0.1:7700

Download the latest stable release of MeiliSearch with Homebrew.

Launch MeiliSearch to start the server.

$ brew update && brew install meilisearch
$ meilisearch
Server is listening on: http://127.0.0.1:7700

Using Docker you can choose to run any available tags (opens new window).

This command starts the latest stable release of MeiliSearch.

$ docker run -it --rm \
    -p 7700:7700 \
    -v $(pwd)/data.ms:/data.ms \
    getmeili/meilisearch
Server is listening on: http://0.0.0.0:7700

Data written to a Docker container is not persistent and is deleted along with the container when the latter is stopped. Docker volumes are not deleted when containers are removed. It is then recommended to share volumes between your containers and your host machine to provide persistent storage. MeiliSearch writes data to /data.ms

Download the latest stable release of MeiliSearch with APT.

Launch MeiliSearch to start the server.

$ echo "deb [trusted=yes] https://apt.fury.io/meilisearch/ /" > /etc/apt/sources.list.d/fury.list
$ apt update && apt install meilisearch-http
$ meilisearch
Server is listening on: http://127.0.0.1:7700

MeiliSearch is written in Rust. To compile it, installing the Rust toolchain (opens new window) is required.

If the Rust toolchain is already installed, clone the repository on your local system and change it to your working directory.

$ git clone https://github.com/meilisearch/MeiliSearch
$ cd MeiliSearch

In the cloned repository, compile MeiliSearch.

# Update the rust toolchain to the latest version
$ rustup update
# Compile the project
$ cargo build --release
# Execute the server binary
$ ./target/release/meilisearch

Configuration Options

Options are added at launch. Either through command line options or through environment variables.

This is an example using the command line options.

$ ./meilisearch --db-path ./meilifiles --http-addr '127.0.0.1:7700'
Server is listening on: http://127.0.0.1:7700

Here is the list of all the options and how to use them.

Updating MeiliSearch

Getting the latest version of MeiliSearch is a straightforward process: simply fetch and install the latest binary with your preferred method (see installation above).

However, please note that prior to our official release (v1.0), all minor updates (v0.X) are considered breaking. Therefore, MeiliSearch databases are not compatible across versions for as long as we are in beta.

If you want to transfer your database from an outdated MeiliSearch instance to the most recent version, we recommend following the below guide.

If you get the error Cannot open database, expected MeiliSearch engine version: X.X.X, current engine version Y.Y.Y, simply delete your database folder (defaults to data.ms), and re-index all your documents.

Migrating a Database to a Later Version

Using dumps, you can export your MeiliSearch data—all indexes, documents, and settings contained in your database—into a transferrable state. Then, you can re-import this data after updating MeiliSearch to the latest version.

Since the content is exported in a way that guarantees mobility, it needs to be re-indexed. If your database is large, this process can take a long time. Nonetheless, this process guarantees to migrate all settings and documents between two different versions of MeiliSearch.

If you want a complete guide on how to update MeiliSearch on DigitalOcean, please look at this GitHub issue (opens new window).