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
exportaction - A command-line terminal
meili teleport creates one for you.
Teleport with the CLI
1. Install the CLI
- npm
- Homebrew
- Install script
2. Run meili teleport
- Asks for the instance to move, from your CLI config file or by its URL and API key
- Checks that the API key can export data
- Logs you in to Meilisearch Cloud in your browser, and creates your account if you do not have one
- 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.
- Adds the new project to your CLI config file
- 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.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 aPOST /export request pointing to your Cloud project:
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 issucceeded, open your Cloud project and run a few searches to confirm all data transferred correctly.
Congratulations, you have migrated to Meilisearch Cloud. If you encounter any problems, reach out to our support team on Discord.