Do you know how to upgrade DNN to the latest version?

If there is an upgrade available (see ["Have you installed the latest DNN version?"](/latest-dnn-version), follow the following steps to perform the upgrade.
**In Preparation:**

1. Back up the DNN database
2. Back up all website files
3. Check your database and website backups!
4. Download the latest DotNetNuke upgrade package:

   A. From the www.dotnetnuke.com site. You may need login credentials if you are using a non-community version of DNN or
   B. Click the "Upgrade Available" button that appears when you are _not_ running the latest version.

5. Create a basic html document called app_offline.htm. This page will be shown on the site while you are doing the upgrade.
   <imageEmbed
  alt="Image"
  size="large"
  showBorder={false}
  figureEmbed={{
    preset: "badExample",
    figure: 'Bad example - No maintenance page. Users may see errors while the site is partially upgraded',
    shouldDisplay: true
  }}
  src="/uploads/rules/upgrade-dnn-to-the-latest-version/nomaintenance.jpg"
/>
   <imageEmbed
  alt="Image"
  size="large"
  showBorder={false}
  figureEmbed={{
    preset: "goodExample",
    figure: 'Good example - HTML page to let users know the site is offline to perform the Upgrade',
    shouldDisplay: true
  }}
  src="/uploads/rules/upgrade-dnn-to-the-latest-version/2024-04-20_13-29-45.png"
/>

**To Perform the Upgrade:**

1. Upload the app_offline.htm file to the root web folder for the site.
2. Navigate to the site in a web browser and check that the app_offline.htm file is shown instead of the usual default page.
3. Copy the contents of the latest DotNetNuke upgrade package over the top of the existing files. All files should be copied because the package should only contain generic files ?no configuration files.
4. When the copy is complete, rename the app_offline.htm file to app_offline.htm.save. When you navigate to the site, you will see a new construction page:
   <imageEmbed
  alt="Image"
  size="large"
  showBorder={false}
  figureEmbed={{
    preset: "goodExample",
    figure: 'Good example - Latest version has been copied and site is unavailable (suggestion to DNN team: remove the underline from the non-link)',
    shouldDisplay: true
  }}
  src="/uploads/rules/upgrade-dnn-to-the-latest-version/removeunderline.jpg"
/>
5. Access the /install/install.aspx?mode=upgrade page (e.g.www.mysite.com/install/install.aspx?mode=upgrade) using a web browser. The site will begin an automatic upgrade process:
   <imageEmbed
  alt="Image"
  size="large"
  showBorder={false}
  figureEmbed={{
    preset: "goodExample",
    figure: 'Good example - Automatic upgrade running',
    shouldDisplay: true
  }}
  src="/uploads/rules/upgrade-dnn-to-the-latest-version/automaticupgraderunning.jpg"
/>
6. On completion of the upgrade, you will see the following message at the bottom of the page. Click on the link to return to the site.
   <imageEmbed
  alt="Image"
  size="large"
  showBorder={false}
  figureEmbed={{
    preset: "goodExample",
    figure: 'Good example - Automatic upgrade completed (suggestion to DNN team: put an underline under the link)',
    shouldDisplay: true
  }}
  src="/uploads/rules/upgrade-dnn-to-the-latest-version/putunderline.jpg"
/>
7. Click through the newly upgraded site to perform a [smoke test](/different-types-of-testing/#1-smoke-testing).
8. Log in to the DNN site and navigate to "Host", then "Host Settings". You will see that the site is running the newest version of DNN and that there are no upgrades available.
   <imageEmbed
  alt="Image"
  size="large"
  showBorder={false}
  figureEmbed={{
    preset: "goodExample",
    figure: 'Good example - Latest version and no upgrades available',
    shouldDisplay: true
  }}
  src="/uploads/rules/upgrade-dnn-to-the-latest-version/latestversionandnoupgrade.jpg"
/>