You are currently browsing legacy 4.1 version of documentation. Click here to switch to the newest 5.1 version.

We can help you with migration to the latest RavenDB

Contact Us Now
see on GitHub

Import from MongoDB/CosmosDB


  • You can import your existing NoSQL Databases to RavenDB.

  • Currently supported:

    • MongoDB
    • CosmosDB
  • You can import all collections, or select specific collections to import.

  • In this page:

Before you start

To migrate data from your existing NoSQL database, you need to download an external tool called Raven.Migrator.
The application is available at ravendb.net/downloads, in the tools package.


Import from MongoDB

Figure 1.

Import from MongoDB

  1. Migrator Path

    • Find Raven.Migrator.exe in the tools package here: ravendb.net/downloads
    • Provide a path to Raven.Migrator.exe's folder.
  2. Database Source

    • Select MongoDB
  3. Connection String

    • Provide the connection string to your MongoDB instance.
  4. Migrate GridFS

    • Choosing this option will import GridFS attachments and save them as documents with attachments in the @files collection.
  5. Database Name

    • Provide the name of the source database.
  6. Migrate all collections

    • You can either import all collections or select the collections you'd like to import.
    • Optionally, you can rename the imported collections.
  7. Use transform script

    • Use a JavaScript to filter / modify imported documents.

Import from CosmosDB

Figure 2.

Import from CosmosDB

  1. Migrator Path

    • Find Raven.Migrator.exe in the tools package here: ravendb.net/downloads
    • Provide a path to Raven.Migrator.exe's folder.
  2. Database Source

    • Select CosmosDB
  3. Azure Endpoint URL

    • Provide a URL to CosmosDB database
  4. Primary Key

    • Provide the Primary key for CosmosDB
  5. Database Name

    • Provide the source database name
  6. Migrate all collections

    • You can either import all collections or select the collections you'd like to import.
    • Optionally, you can rename the imported collections.
  7. Use transform script

    • Use a JavaScript to filter / modify imported documents.