Take the community feedback survey now.

Scott Reed
Aug 10, 2021
  3182
(2 votes)

.NET 5 Preview - DXP Changes

Overview

The .NET 5 preview is a major update to the Optimizely CMS platform. The public preview was released on July 1st as announced by Martin Ottosen here https://world.episerver.com/blogs/martin-ottosen/dates/2021/6/-net-5-public-preview/ and with it comes a number of features as mentioned in my previous blog post.

If you’ve not read it you can read the full list here

In this series of blog posts, I’m going to give an overview of what to expect in this version based upon my own exploration and usage. I will compare what we had to what we have to give developers an easier understanding of where the platform has changed.

In this third post I am going to give a high-level overview of what is looking to change on the DXP with the .NET 5 version.

Linux Web Apps

Due to the fact that we've been running on full fat .NET for many years we've been limited to being only able to run our solutions on a Windows based infrastructure. With the move to .NET 5 the team believes Linux Web Apps will be better in the long term for running apps. I assume as well somewhere down the line support for containers/orchestration will be on the cards with all these changes to be for a more modern DevOps system. 

Config Transforms

As updated in my Alloy blog post as we do not have any Web.Config we do not have transforms anymore. We do see however in the Alloy demo some .JSON files with configuration names in them however for these files from now on they do not trasnform they just load the correct environment directly from the file. E.g if you have appsettings.Integration that will load the integration settings. This means 2 considerations

  1. Make sure to have any .JSON config files have the exact settings you want per environment
  2. Make sure that your configuration middleware loads the correct settings you want based on the environment you're using as you can no longer load settings from web.config.

Deployments

I've heard a couple of things around deployments to be aware of with this move that's very important

  1. With this version of .NET the Deployment API will only be supported. Therefore you'll have to make sure your DevOps processes are migrated to using it as soon as you can. This may be an opportunity to pre prepare for the version update ahead of time to reduce time/effort in the migration. To note once you have a package on Integration you can use the DXP Pass Portal to deploy it up to prep/prod.
  2. To start there will be no maintenance page option availible for Linux DXP sites in the deployment process.
Aug 10, 2021

Comments

Please login to comment.
Latest blogs
Optimizely Opal — working notes from me

A short, practical orientation I use when introducing Opal. Lately I’ve been helping customers and developers understand Opal, and I kept finding...

Pär Wissmark | Nov 26, 2025 |

How to setup Entra ID (formerly Azure AD) for CMS 12 site

Recently, I created a doc about configuring AAD with CMS 12, but it has been posted internally only So today, I would like to introduce it again in...

Tuan Anh Hoang | Nov 25, 2025

Running Optimizely CMS 12 on .NET 10 in Azure

Upgrade your Optimizely CMS website to .NET 10!

Tomas Hensrud Gulla | Nov 21, 2025 |

Experimentation Evolution with AI (Masterclass Recap)

If you think you are not using AI in your experimentation program you are probably wrong. Ever asked an AI to rephrase a hypothesis or brainstorm a...

Polly Walton | Nov 21, 2025