NavigationContentFooter
Suggest an edit
Was this page helpful?

Migrating data with mongosync

Reviewed on 30 June 2025Published on 30 June 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.

Important

Refer to the official PostgreSQL documentation for a list of Cluster-to-Cluster sync’s limitations

Before you startLink to this anchor

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.

Was this page helpful?
API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2025 – Scaleway