Migrating data with mongosync

Reviewed on June 30, 2025

Scaleway Managed MongoDB® is compatible with the MongoDB® Cluster-to-Cluster tool.

Cluster-to-Cluster sync helps you migrate data from one cluster to another without downtime through synchronization. Until the sync is finalized, the tool replicates and writes data from one cluster to another.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• A MongoDB® Database Instance
• Installed a MongoDB®-compatible client
• Set up your environment variables for the Scaleway API

1. Create a user in your MongoDB® Instance. Make sure you replace <user-name>, <password> and {instance_id} with the user name of the user, its password and the MongoDB® Instance UUID, respectively.

   curl -X POST \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     -H "Content-Type: application/json" \
     -d '{"name":"<user-name>","password":"<password>"}' \
     "https://api.scaleway.com/mongodb/v1/regions/fr-par/instances/{instance_id}/users"

2. Apply the sync role to the user for any database. The db_adminrole also allows you to sync.

3. Download and install mongosync for your host system.

   Tip

   If the database you want to sync is bigger than 100 GB, we recommend you use a Scaleway Instance to sync.

4. Connect the clusters.

5. Migrate data between clusters.

6. Finalize the cut-over process.