Skip to main content

​
Requirements

  • A running Meilisearch instance
  • A command-line terminal
  • A Meilisearch Cloud account and project

​
Export API

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: 
curl \
  -X POST 'MEILISEARCH_URL/export' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "url": "TARGET_INSTANCE_URL",
    "indexes": {
      "*": {
        "overrideSettings": true
      }
    }
  }'
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.