Migrating from .NET 9 to .NET 10 Print

Overview

.NET 10 is a Long-Term Support (LTS) release, supported until November 2028. This makes it an excellent upgrade target for production applications currently running on .NET 9.

Why Upgrade to .NET 10?

• LTS Support: 3 years of support until November 2028
• Performance: Continued improvements to JIT, GC, and runtime
• Blazor: Enhanced Web App model with passkey authentication
• Security: Latest security patches and improvements

Step 1: Update Target Framework

Modify your .csproj file:

<!-- Before -->
<TargetFramework>net9.0</TargetFramework>

<!-- After -->
<TargetFramework>net10.0</TargetFramework>

Step 2: Update All NuGet Packages

dotnet outdated --upgrade

Ensure all Microsoft.AspNetCore.*, Microsoft.EntityFrameworkCore.*, and related packages are updated to 10.x versions.

Step 3: Review Breaking Changes

Key areas to review:

• Removed obsolete APIs from previous versions
• Blazor component model updates
• Authentication and Identity changes
• EF Core 10 changes

Always consult Microsoft's official migration documentation for the complete list.

Step 4: Blazor-Specific Updates

For Blazor applications:

• Review new render mode defaults
• Update authentication to use passkeys if desired
• Check for deprecated Blazor APIs

Step 5: Build and Test

dotnet clean
dotnet restore
dotnet build
dotnet test

Run comprehensive tests before deployment.

Step 6: Update Plesk Settings

1. Log in to Plesk control panel
2. Go to Websites & Domains → your domain
3. Click Hosting Settings
4. Change .NET Core Version to 10.0.x
5. Click OK

Step 7: Deploy

dotnet publish -c Release -o ./publish

Deploy using your preferred method (Web Deploy, FTP, or File Manager).

Post-Migration Checklist

• Verify all pages and functionality work correctly
• Check application logs for any warnings
• Monitor performance for the first few days
• Update any CI/CD pipelines to use .NET 10 SDK

Benefits of .NET 10 LTS

By migrating to .NET 10 LTS, you benefit from:

• Extended support timeline
• Regular security updates
• Stable platform for production workloads