Skip to content

Update DNN version to 10.02.03 in upgrade path #781

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
valadas merged 3 commits into from
Mar 19, 2026
Merged

Update DNN version to 10.02.03 in upgrade path #781

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3604202
Update DNN version to 10.02.03 in upgrade path
jeremy-farrance Mar 11, 2026
df04c2d
Update upgrade paths and add note for 09.13.10
jeremy-farrance Mar 13, 2026
5662c36
Revise upgrade path and requirements for DNN
jeremy-farrance Mar 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 39 additions & 37 deletions content/getting-started/setup/upgrades/suggested-upgrade-path/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
uid: setup-upgrades-suggested-upgrade-path
locale: en
title: DNN Platform Suggested Upgrade Path
dnnversion: 10.01.02
dnnversion: 10.02.03
---

# DNN Platform Suggested Upgrade Path
Expand All @@ -13,45 +13,47 @@ Following is the recommended upgrade path for **DNN Platform** based on the expe

The below is, of course, subject to change. If your current version of DNN Platform is between any of the versions listed below, first upgrade to the closest listed version. For instance, if you are starting with version 09.02.00, you should upgrade first to version 09.03.02.

|**FROM Version**|**TO Version**|
|---|---|
|[02.00.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.2x/tree/master/02.00.04)|[02.01.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.2x/tree/master/02.01.02)|
|[02.01.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.2x/tree/master/02.01.02)|[03.01.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.01.01)|
|[03.01.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.01.01)|[03.02.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.02.02)|
|[03.02.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.02.02)|[04.03.07](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.03.07)|
|[04.03.07](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.03.07)|[04.04.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.04.01)|
|[04.04.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.04.01)|[04.06.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.06.02)|
|[04.06.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.06.02)|[04.09.05](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.09.05)|
|[04.09.05](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.09.05)|[05.04.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.04.04)|
|[05.04.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.04.04)|[05.06.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.06.08)|
|[05.06.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.06.08)|[06.02.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.6x/tree/master/06.02.08)|
|[06.02.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.6x/tree/master/06.02.08)|[07.04.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.7x/tree/master/07.04.02)|
|[07.04.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.7x/tree/master/07.04.02)|[08.00.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.8x/tree/master/08.00.04)|
|[08.00.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.8x/tree/master/08.00.04)|[09.01.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.1.1)|
|[09.01.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.1.1)|[09.03.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.3.2)|
|[09.03.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.3.2)|[09.13.09](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.09)|
|[09.13.09](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.09)|[10.02.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.2.1)|
|[10.02.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.02.01)|[10.02.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.2.2)|
|**FROM Version**|**TO Version**|**Notes**|
|:---:|:---:|:---|
|[10.02.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.02.01)|[10.02.03](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.2.3)|*use [New Upgrade Process](xref:setup-upgrades-post-10.2.0)*|
|[09.13.09](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.09)|[10.02.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.2.1)|see notes below 10.0.0, 10.1.1, 10.2.0|
|[09.03.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.3.2)|[09.13.09](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.09)|see notes below 9.8.0, 9.4.0|
|[09.01.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.1.1)|[09.03.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.3.2)|see notes below 9.2.0|
|[08.00.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.8x/tree/master/08.00.04)|[09.01.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.1.1)||
|[07.04.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.7x/tree/master/07.04.02)|[08.00.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.8x/tree/master/08.00.04)||
|[06.02.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.6x/tree/master/06.02.08)|[07.04.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.7x/tree/master/07.04.02)|see note below 7.0.0|
|[05.06.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.06.08)|[06.02.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.6x/tree/master/06.02.08)||
|[05.04.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.04.04)|[05.06.08](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.06.08)||
|[04.09.05](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.09.05)|[05.04.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.5x/tree/master/05.04.04)|see note below 5.3.0|
|[04.06.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.06.02)|[04.09.05](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.09.05)||
|[04.04.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.04.01)|[04.06.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.06.02)||
|[04.03.07](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.03.07)|[04.04.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.04.01)||
|[03.02.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.02.02)|[04.03.07](https://github.com/dnnsoftware/Dnn.Releases.Archive.4x/tree/master/04.03.07)|see note below 3.2.2|
|[03.01.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.01.01)|[03.02.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.02.02)||
|[02.01.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.2x/tree/master/02.01.02)|[03.01.01](https://github.com/dnnsoftware/Dnn.Releases.Archive.3x/tree/master/03.01.01)||
|[02.00.04](https://github.com/dnnsoftware/Dnn.Releases.Archive.2x/tree/master/02.00.04)|[02.01.02](https://github.com/dnnsoftware/Dnn.Releases.Archive.2x/tree/master/02.01.02)||

> [!NOTE]
> If you are in a situation where you are unable to make the 09.13.09 -> 10.x upgrade, there is a hot-fix release [09.13.10](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.10). This was a special release that contains security patches through the DNN 10.02.00 release and can be used during periods when a 10.x upgrade is not possible. For a successful upgrade, it is NOT necessary to stop at 09.13.10 prior to upgrading to 10.x. There is NO guarantee that any future 9.13.x releases will be made, therefore it is suggested to try to prepare for a 10.x upgrade as soon as practical.
> If you are in a situation where you are unable to make the 09.13.09 -> 10.x upgrade, there is a hot-fix release [09.13.10](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.10). This was a special release that contains security patches through the DNN 10.02.00 release and can be used during periods when a 10.x upgrade is not yet possible. For a successful upgrade, it is NOT necessary to stop at 09.13.10 prior to upgrading to 10.x. There is NO guarantee that any future 9.13.x releases will be made, therefore it is suggested to try to prepare for a 10.x upgrade as soon as practical.

> [!NOTE]
> If upgrading from DNN 10.02.x and later, it is strongly recommended to follow the new upgrade process outlined in the [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0)

> [!TIP]
> **Upgrade Notes:** DotNetNuke has been around since 2002, and in that time has had a number of changes which can complicate matters during the process of upgrading through different versions. These include:
> **Upgrade Notes:** DotNetNuke has been around since 2002, and in that time has had a number of changes which can complicate matters during the process of upgrading through different versions. Please review the list below carefully:

> [!NOTE]
> If upgrading from DNN 10.02.02 and later, it is strongly recommended to follow the new upgrade process outlined in the [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0)

## Requirements Changes & Prerequisites
- The changeover from DNN 3.x to DNN 4.x - DNN 3.x used ASP.NET 1.1, whereas DNN 4.x and above require ASP.NET 2.0.
- Editions prior to 4.6.2 - Prior to 4.6.2 site admins had to manually merge a number of key fields in web.config such as the machinekey and both connection strings. With 4.6.2 DotNetNuke introduced functionality known as xmlmerge which automatically does the web.config merging on your behalf.
- 3.02.02 - 4.03.07 - Please refer to the Detailed installation guide "[Upgrade to DotNetNuke 4.x chapter](https://www.dnnsoftware.com/LinkClick.aspx?fileticket=gOZGbvrVKJw%3d&tabid=478&mid=857)". This blog post also contains information about upgrading from 3.2.2. to 4.x: [Preparing for an upgrade](https://www.dnnsoftware.com/community-blog/cid/135317/preparing-for-an-upgrade)
- DotNetNuke 5.2 - This version introduced the requirement for SQL 2005 and ASP.NET 3.5 SP1.
- When upgrading from a version before 5.3.0 to after 5.3.0, you may encounter this error during the upgrade: “Type 'Web.HttpResponse' is not defined.” This error primarily occurs if an the XML module is already installed. To prevent this, please check PRIOR to upgrading if the XML module is installed in your DotNetNuke version. If it is installed, please upgrade it PRIOR to upgrading DotNetNuke to version 4.3.5, available at [DNN.XML Module on GitHub](https://github.com/DNNCommunity/DNN.XML).
- With the 7.0 release DotNetNuke has some additional changed pre-requisites, please see the [DNN 7 Developer Quick Start](https://www.dnnsoftware.com/wiki/dotnetnuke-70-developer-quick-start#Pre-requisites_0) for further details.
- In DNN 9.2.0, multiple APIs were removed that were marked deprecated in DNN 7 and before. Most of the core modules have been updated since and you can find them at [https://github.com/dnncommunity](https://github.com/dnncommunity). If you have other modules installed, please check for updates before upgrading to DNN 9.2.0 or later.
- DNN 9.4.0 introduced a minimum requirement of ASP.NET 4.7.2.
- DNN 9.8.0 (and above for the 9.x series releases) brings the OPTIONAL (but HIGHLY RECOMMENDED) [Telerik Removal](xref:setup-telerik-removal).
- DNN 10.0.0 introduced minimum requirements for ASP.NET 4.8 and SQL Server 2017. In addition, it will force-remove DNN-Provided Telerik versions.
- DNN 10.1.1 new installs use SHA256 as the default password hashing algorithm. This only affect new installs, if you want to migrate an upgraded site to SHA256, please read [the documentation for membership provider changes](xref:security-membership-providers).
## Notes, Requirements, Changes, and Prerequisites
- DNN 10.2.0 introduced a new simplified upgrade process, see [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0).
- DNN 10.2.0 introduced a [new CDF replacement](https://github.com/dnnsoftware/Dnn.Platform/issues/6643) (affects themes/skins) and removed CSS/JS bundling and minification
- DNN 10.1.1 new installs use SHA256 as the default password hashing algorithm. This only affect new installs, if you want to migrate an upgraded site to SHA256, please read [the documentation for membership provider changes](xref:security-membership-providers).
- DNN 10.0.0 introduced minimum requirements for ASP.NET 4.8 and SQL Server 2017. In addition, it will force-remove DNN-Provided Telerik versions.
- DNN 10.0.0 is a significant release with both [Breaking Changes and New Features](https://dnncommunity.org/blogs/Post/20257).
- DNN 9.8.0 (and above for the 9.x series releases) brings the OPTIONAL (but HIGHLY RECOMMENDED) [Telerik Removal](xref:setup-telerik-removal).
- DNN 9.4.0 introduced a minimum requirement of ASP.NET 4.7.2.
- DNN 9.2.0 multiple APIs were removed that were marked deprecated in DNN 7 and before. Most of the core modules have been updated since and you can find them at [https://github.com/dnncommunity](https://github.com/dnncommunity). If you have other modules installed, please check for updates before upgrading to DNN 9.2.0 or later.
- DNN 7.0.0 has some additional changed pre-requisites, please see the [DNN 7 Developer Quick Start](https://www.dnnsoftware.com/wiki/dotnetnuke-70-developer-quick-start#Pre-requisites_0) for further details.
- DNN 5.3.0 upgrading from a version before 5.3.0 to after 5.3.0, you may encounter this error during the upgrade: “Type 'Web.HttpResponse' is not defined.” This error primarily occurs if an the XML module is already installed. To prevent this, please check PRIOR to upgrading if the XML module is installed in your DotNetNuke version. If it is installed, please upgrade it PRIOR to upgrading DotNetNuke to version 4.3.5, available at [DNN.XML Module on GitHub](https://github.com/DNNCommunity/DNN.XML).
- DotNetNuke 5.2.0 introduced the requirement for SQL 2005 and ASP.NET 3.5 SP1.
- DotNetNuke 4.6.2 **prior to 4.6.2** site admins had to manually merge a number of key fields in web.config such as the machinekey and both connection strings. With 4.6.2 DotNetNuke introduced functionality known as xmlmerge which automatically does the web.config merging on your behalf.
- DotNetNuke 3.2.2 to 4.3.7 please refer to the Detailed installation guide "[Upgrade to DotNetNuke 4.x chapter](https://www.dnnsoftware.com/LinkClick.aspx?fileticket=gOZGbvrVKJw%3d&tabid=478&mid=857)". This blog post also contains information about upgrading from 3.2.2. to 4.x: [Preparing for an upgrade](https://www.dnnsoftware.com/community-blog/cid/135317/preparing-for-an-upgrade)
- DotNetNuke 3.x to 4.x changeover - DNN 3.x used ASP.NET 1.1, whereas DNN 4.x and above require ASP.NET 2.0.
Loading