Skip to main content

Upgrade to .NET Core 3.1

Use this guide to upgrade to .NET Core 3.1. This step is necessary for upgrading to SecureAuth® Identity Platform release 22.02 or later.

Upgrade steps

  1. To uninstall .NET Core 2.1, do one of the following:

    • Go to System Settings > Add or remove programs and select Microsoft .NET Core 2.1. Click Uninstall.

    • In a command line program, go to the directory that contains dotnet-hosting-2.1-win.exe and run the following command:

      dotnet-hosting-2.1-win.exe /uninstall
  2. Run the updater in the Upgrade Package to upgrade the Identity Platform to release 22.02.

  3. Go to D:\MFCApp_Bin\Extras\.NETCore2HostingComponents.

  4. Run dotnet-hosting-3.1.18-win.exe.


As best practice, SecureAuth recommends uninstalling .NET Core 2.1 before installing .NET Core 3.1 to avoid accidentally removing dependencies needed for IIS. If, for any reason, you remove .NET Core 2.1 after installing .NET Core 3.1, follow these steps:

  1. Go to D:\MFCApp_Bin\Extras\.NETCore2HostingComponents.

  2. Run dotnet-hosting-3.1.18-win.exe.

  3. Click Repair.