Data Migration



Replacing the binaries

  • Starting with RavenDB 6.2, the .exe files are self-contained,
    bundling all necessary .dll files and dependencies into a single executable.

  • When migrating to 6.2, ensure you first remove ALL previous binaries (DLL and EXE files),
    and then add the following .exe files from the update package:

    • Raven.Server.exe
    • Raven.Debug.exe
    • rvn.exe

  • Be cautious not to overwrite your settings.json (if it was customized), your server certificate,
    or any other configuration files you have added if they reside in your server directory.

  • Additionally, if you keep your data directory under the server directory,
    make sure you don't delete or overwrite it.

Migration from RavenDB 5.x to 6.x

  • RavenDB 6.x supports in-place migration of data from RavenDB 5.x.
  • During the first startup after replacing the binaries with the new ones, the data will migrate automatically.
  • RavenDB 5.x product licenses do not apply to RavenDB 6.x.
    To upgrade a valid 5.x license to a RavenDB 6.x license,
    please use the License upgrade tool as explained here.

Please note that once upgraded, RavenDB 6.x cannot be downgraded to version 5.x,
and the migrated data will no longer be accessible via RavenDB 5.x.
Please create a backup of your data before migrating.

Migration from RavenDB 4.x to RavenDB 5.x and 6.x

  • RavenDB 5.x supports in-place migration of data from RavenDB 4.x.

    It is also possible to upgrade directly from version 4.x to 6.x,
    but it is recommended to first upgrade RavenDB 4.x to 5.x, and then proceed from 5.x to 6.x.

  • During the first startup after replacing the binaries with the new ones, the data will migrate automatically.
  • RavenDB 4.x product licenses do not apply to RavenDB 6.x.
    To upgrade a valid 4.x license to a RavenDB 6.x license,
    please use the License upgrade tool as explained here.

Please note that once upgraded, RavenDB 6.x cannot be downgraded to version 4.x,
and data migrated to 5.x or 6.x will no longer be accessible via RavenDB 4.x.
Please create a backup of your data before migrating.

Migration from RavenDB 3.x

  • The information above relates only to data migration from RavenDB 4.x to 5.x/6.x and from 5.x to 6.x.
  • If you want to migrate your data from a RavenDB version earlier than 4.x,
    please read the dedicated article here.

Migrating data into a sharded database

If you want to migrate your data to a sharded database (supported by RavenDB 6.0 and above),
please read the related article here.

Do you need any help with Migration?