Coding⏱️ 3 min read📅 2026-06-03

How to Fix: Need to Update EF Core Tools

Update EF Core tools to the latest version in your csproj file.

Quick Answer: Update the DotNetCliToolReference in your csproj file to use the latest version, e.g. Microsoft.EntityFrameworkCore.Tools.DotNet Version="2.1.3"

When using the dotnet ef tools in the VS 2017 Package Manager Console, you may encounter a warning message indicating that the EF Core tools version is older than the runtime. This issue affects users who have installed the EF Core Tools package without updating it to the latest version.

This error can be frustrating for developers who rely on the dotnet ef tools for database management and migration tasks. Fortunately, updating the EF Core tools to the latest version is a straightforward process that can resolve this issue.

🛑 Root Causes of the Error

  • The primary reason for this warning message is that the EF Core Tools package may not be compatible with the runtime version installed in your environment. This can happen when the package is not updated regularly, allowing older versions to accumulate and cause compatibility issues.
  • Alternatively, it's also possible that the issue arises from a misconfigured project file or a corrupted NuGet package cache. In such cases, deleting the package cache and reconfiguring the project may resolve the problem.

✅ Best Solutions to Fix It

Updating EF Core Tools via Package Manager Console

  1. Step 1: Open the VS 2017 Package Manager Console and navigate to the directory containing your .csproj file.
  2. Step 2: Type the following command to update the EF Core tools: dotnet ef --update-toolshed. This will download and install the latest EF Core Tools package.
  3. Step 3: Once the update is complete, verify that the tools version has been updated by running the dotnet ef migrations list -s command again.

Alternative Fix Method: Reconfiguring Project File

  1. Step 1: Open the .csproj file in a text editor and update the DotNetCliToolReference element to point to the latest EF Core Tools package version.
  2. Step 2: Specifically, change the Version attribute from '2.1.2' to '2.1.3' or the latest available version. Save the changes and close the file.
  3. Step 3: Restart the Package Manager Console and try running the dotnet ef migrations list -s command again to verify that the tools version has been updated.

🎯 Final Words

By following these steps, you should be able to resolve the EF Core Tools version compatibility issue and continue using the dotnet ef tools without any warnings or errors. Remember to regularly update your packages to ensure the latest features and bug fixes are available for your projects.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions