Skip to main content

Requirements

  • A running Meilisearch instance, v1.16 or later
  • If the instance has a master key, that master key or an API key with the export action
  • A command-line terminal
You do not need a Meilisearch Cloud account. meili teleport creates one for you.

Teleport with the CLI

1. Install the CLI

Installing with npm requires Node.js 22 or later.

2. Run meili teleport

The command asks its questions in the terminal. It:
  1. Asks for the instance to move, from your CLI config file or by its URL and API key
  2. Checks that the API key can export data
  3. Logs you in to Meilisearch Cloud in your browser, and creates your account if you do not have one
  4. Creates the Cloud project: a free trial project if your account has not used its free trial yet, or a project on the plan you choose. Paid plans require a payment method in your Cloud account. See the pricing page.
  5. Adds the new project to your CLI config file
  6. Sends your data to the new project and waits until it is indexed

3. Verify the migration

Open your Cloud project and run a few searches to confirm all data transferred correctly.
To migrate without questions, for example in a script, first run meili auth login yourself: it opens your browser to log in to Meilisearch Cloud. The script can then run meili project add and meili export. See the CLI README.

Export API

If you prefer not to use the CLI, the export API pushes your data directly from your self-hosted instance to a remote Meilisearch instance without creating any intermediate files.

1. Create a Meilisearch Cloud project

Navigate to Meilisearch Cloud and create a new project. Once it is ready, note down your project URL and API key from the project overview.

2. Run the export

On your self-hosted instance, send a POST /export request pointing to your Cloud project:
Replace TARGET_INSTANCE_URL with your Cloud project URL and add your Cloud API key via the apiKey field or an Authorization header. Meilisearch returns a task object. Use the taskUid to monitor its progress.

3. Verify the migration

Once the task status is succeeded, open your Cloud project and run a few searches to confirm all data transferred correctly.
Meilisearch Cloud automatically generates a new master key during project creation. If you are using security keys, update your application to use the newly generated Meilisearch Cloud API keys.
Congratulations, you have migrated to Meilisearch Cloud. If you encounter any problems, reach out to our support team on Discord.