Migration error - The database version does not match the project version

2025/03/18 10:41 PM

I followed the instructions in the link below to migrate content from a Kentico 12 MVC site to Xperience by Kentico.

I ran 'dotnet new install kentico.xperience.templates' in the terminal and followed the process to create a new project resulting in a fresh version 30.2.2

Running Migration.Tool.CLI.exe migrate resulted in the following error

"Error occured System.NotSupportedException: The database version '30.2.2' does not match the project version '30.2.0', please check your connection string."

Update: Updating the Kentico NuGet packages in the migration toolkit project to match my Xperience by Kentico project version solution fixed the problem.

Environment

Answers

2025/03/18 10:44 PM
Accepted answer

The version of Kentico in the upgrade toolkit needs to match the version you are migrating to.

Just update the kentico related NuGet packages to 30.2.2

2025/03/18 10:58 PM

The Kentico Migration Tool (part of the Xperience by Kentico Migration Toolkit) has a version matrix in the repository's README.md. This matrix is updated every time the Kentico Migration Tool is updated to support the latest version of Xperience by Kentico.

If you are using a newer version of Xperience by Kentico than what the Kentico Migration Tool supports, you can try updating the NuGet package dependencies yourself but we can't guarantee product support until we update the tool ourselves.

We try to keep the tool up to date with the latest Refreshes and hotfixes for Xperience, but we have to wait until those NuGet packages are released to use them in our open-source integrations, so we'll typically be 1-2 weeks behind and might not support every hotfix version. Updates typically include accommodating new features in Xperience by Kentico along with changing the package dependencies.

Check out the Releases list on GitHub to see recent changes to the tool.

2025/03/18 11:11 PM

Sean, if I was using an older version for my project, would I need to use an older version of the toolkit as well? I didn't see this specified in the documentation, although I did notice the matrix.

2025/03/18 11:36 PM

Good question. There are 2 scenarios

  1. Your application uses a newer version of Xperience than the latest version of the Kentico Migration Tool supports.
    I recommend opening an issue in the repository and requesting an update to support the latest version of Xperience by Kentico.

    However, you can avoid this by starting your Xperience by Kentico project on the same version of Xperience that the current version of the Kentico Migration Tool supports (if you know you'll be migrating content).
  2. Your application uses an older version of Xperience than the latest version of the Kentico Migration Tool requires.
    This one is simple 😀. Upgrade your Xperience by Kentico application to the same version of Xperience supported by the Kentico Migration Tool.

I wouldn't ever recommend using an older version of the Kentico Migration Tool because of all the feature enhancements and bugfixes that are regularly added to it.

To response this discussion, you have to login first.