July 12th, 2022

.NET Core 3.1 will reach End of Support on December 13, 2022

Dominique Whittaker
Senior Program Manager

.NET Core 3.1 will reach end of support on December 13, 2022. After that date, Microsoft will no longer provide servicing updates or technical support for .NET Core 3.1. We recommend moving to .NET 6 as soon as possible. If you are still using .NET Core 3.1 after the end of support date, you’ll need to update your app to .NET 6 or .NET 7 to remain supported and continue to receive .NET updates.

.NET Core 3.1 apps will continue to run after the end-of-support date. Nothing about them will change. However, every security fix in .NET 6 after the end of support date is a potential documented and unpatched security vulnerability for .NET Core 3.1 apps.

You can learn more about .NET release policies:

Update your application

If your application uses NET Core 3.1, we strongly recommend you migrate your application to .NET 6 – a supported LTS version. You can download .NET 6 from the .NET website.

If you’re an end user, we recommend reaching out to the vendor managing your software to confirm whether an updated version of the software is needed and available. The remainder of this post is applicable to software vendors and developers.

Upgrading to .NET 6

  • Open the project file (the .csproj, .vbproj, or *.fsproj file).
  • Change <TargetFramework>netcoreapp3.1</TargetFramework> to <TargetFramework>net6.0</TargetFramework>.

You may also want to review the .NET 6 Compatibility Guide.

Update your development environment

In addition to the software you ship to your customers, the computer you use for development may have .NET Core 3.1 installed – either standalone or installed by Visual Studio.

You can check for stand-alone installations of .NET Core 3.1 from the command line. On a Windows computer, open a Command Prompt and go to %ProgramFiles%dotnet folder. On macOS or Linux, open a terminal window.

Then type the following command: dotnet –list-runtimes

Screen Shot 2022-06-24 at 8 32 04 AM

If you use Visual Studio 2019 16.11 or 17.0 or Visual Studio 2022 17.2, then based on the workloads installed, you may also have .NET Core 3.1 installed as a required component of Visual Studio and you need to be aware of some relevant changes that are coming.

workloads

dotnet components

Starting with the December 2022 servicing update for Visual Studio 2019 16.11, Visual Studio 2019 17.0, and Visual Studio 2022 17.2, the .NET Core 3.1 component in Visual Studio will be changed to out of support and optional. This means that workloads in Visual Studio may be installed without installing .NET Core 3.1. Note that existing installations won’t be affected and any previously installed workload and component will remain installed until the component or workload is unselected in Visual Studio setup. While it’s possible for you to re-select this optional component in Visual Studio and re-install this, we strongly recommend you use .NET 6 with Visual Studio 2022 to build apps that run on a supported .NET runtime.

Note: If you’re migrating an app to .NET 6, some breaking changes might affect you. We recommend you to go through the compatibility check.

Useful Links

Author

Dominique Whittaker
Senior Program Manager

3 comments

Discussion is closed. Login to edit/delete existing comments.

  • W L

    Unity is trying to migrate to .NET 6, can they finish it before .NET 6 reach End of Support?

  • DeVries, Alan

    It is appalling that Microsoft now thinks of three years as “long term” support. Here in the real world, we deal with applications that have 5, 10, 15, or 20+ year lifetimes. Yes, even web applications.

    • Thomas C

      Can you give an example of a web framework that gives 20+ years of support?