Move Creatio .NET 6 to .NET 8
Since Microsoft ended official support for .NET 6 in November 2024, starting from version 8.2.1 Creatio no longer supports .NET 6 and switches to .NET 8.
You can migrate Creatio .NET 6 to .NET 8 as part of the Creatio update process. In general, the migration procedure comprises the following steps:
- Prepare the application server. Read more >>>
- Adapt custom C# code. Read more >>>
- Update Creatio. Read more >>>
Step 1. Prepare the application server
The server must contain software required for .NET 8 to operate as intended. As such, install the following components into the server:
- .NET 8 SDK version 8.0.404 or later. You can download it from the official Microsoft website. Download.
- Hosting Bundle for ASP.NET Core Runtime version 8.0.11 or later (for Windows). You can download it from the official Microsoft website. Download.
Step 2. Adapt custom C# code
If you customized Creatio only using no-code tools, skip this step.
Depending on the libraries you used in C# schemas to customize Creatio, you might need to adapt custom C# code when moving to .NET 8. Learn more about breaking changes in .NET 8 that might require code adaptation in the official Microsoft documentation: Breaking changes in .NET 8.
To find custom C# code to adapt, we recommend updating a test or pre-production environment to .NET 8 first and testing the functionality implemented using custom C# code on the environment. This lets you find breaking changes that only appear in runtime and adapt required code before updating the production environment.
Step 3. Update Creatio
The update process is similar to updating Creatio .NET 6. However, you have to use Creatio .NET 8 archive as part of the update. Learn more about updating Creatio in a separate article: Update guide.
If you adapted custom C# code, install packages that contain adapted code into the environment after you update it.